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by Frank Hudson & Loren Lovhaug 

owdy, I’m Frank Hudson, the new employee around here. You 
might have seem my name around the last couple of issues, or 
seen my name on Qlink in the 128 support area. Twin Cities 
128 is not new to me however, in fact I’ve read it since the 
very first issue. I even read TC128 before I had a 128, when 
I was a C-64 owner dreaming of the 128’s added abilities. 
That glorious day I first hit the power switch on my own new 
128, a stack TC128’s was beside me, guiding me in my 
explorations. Yes, TC128 was one of the reasons I bought a 
128 and make good use of it after purchase. 


IT’S NOT A MAGAZINE, IT’S A WAY OF LIFE: ' 
Those early issues had a lot to offer the beginner, extolling 
the virtues of our favorite machine, explaining how to utilize _ 
the new software and hardware emerging for it, and holding it 
all together with a contagious sense of fun and excitement 
that helped me learn. Now that I’m here, getting to see the 
letters from subscribers, I find that many of you care as much 
about the 128 and TC128 as I do. 


I’m no longer just another TC128 reader, or a 128 beginner 
either, but I never developed into much of 128 programmer. 
With easy to use tools like BASIC 7.0 and BASIC 8.0, this out 
come wasn’t the 128’s fault, it’s just that applications such 
as Pocket Writer and GEOS series made working and creating 
with the 128 so attractive I rarely found the time to write my 
own code. As Twin Cities 128 developed, it became the place 
to find the latest in 128 programming tips and the magazine 
has played a big part in the exploration of the 128’s _ 
hi-resolution — modes among other things. Since I 
don’t program, do I resent this part of the magazine? No way. 
I want to have new 128 goodies, and TC128 Betting the news out 
to programmers helps make that possible. And this ; 
non-programmer enjoys eee in today’s TC128 articles, 
tomorrow’s advances in 128 software! 


If you are like me, a non-programmer, wondering if TC128 will 
continue to serve you, stay tuned! One of my chief jobs 
around here will be to maintain and strengthen our coverage of 
topics of interest to beginners and plain garden variety 
users. It’s my hope you'll agree vith me that this 
a remains required reading for all serious users of 

e 128. We’re going to continue reviewing all the 128 _ 
applications we can get our hands on: with honest, experienced 
reviews that will really ap Ep decide which hardware and 
software fits your needs. And those power user tips on how to 
get the most from software you already have ae ee to 
continue too. When neat new stuff becomes available, TC128 is 
the place to read about it. 


IT’S NOT JUST A WAY OF LIFE, IT’S A JOB: 

It’s a homes, dirty i looking at all the new stuff being __ 
released for the 128, but hey, somebody’s got to do it. t 
now the staff at TC128 World Headquarters is enjoying the new 
V2.0 of GEOS 128 and gertary: new ete to import graphics 
into the 128 environment. GEOS 128 2.0 is somewhat . 
bittersweet experience for me after seeing what BSW did for 
the Apple // user last year. Maybe they felt sorry for those 

poor souls who paid so much for their Apples only to get an 
approximation of the 128’s overall abilities--but the Alar 

coated brand got 80 column GEOS 2.0 first, and with a real 
manual, no DOS coe protection, and a couple of additional 
capabilities. Oh BSW--after all us Commodore users have done 
ee You go and eg the kids milk money on that painted 
and fruited floozy! Stil and all, GEOS is one of those disks 

that is always near the front of my file box. And our GEOS 
article is more than a review, it should help the GEOS user 

get more out of this package. 


It’s pretty a eng things happen around my new 
workplace. Graphics are constantly being swiped from more 
expensive systems and ported to the 128 with all their detail 
intact. There is the constant evaluation of new software, 

both commercial ann para domain keeping all of the screens 
lit with excitement. Watching Rick Kane or Loren demonstrate 
their latest interlace mode discoveries is also a real thrill. 
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Logging on Q-link and GEnie in an attempt to stay current, 
answering mail and processing orders, not peat from the US. 
and Canada mind you, but from Australia, England, Ireland, and 
Norway, fill out the rest of my workday. With all the flurry 

of activity around here it is a wonder Loren and Avonelle 
managed to get a magazine out the door! And as I learn the 
ropes, I’m discovering that Twin Cities 128, is not just a 

job, it’s an adventure. 


AND NOW A FEW WORDS FROM THE BOSS... 
Hi gang, I am Loren Lovhaug, and since January of 1986 I have 
been turning out North America’s only C-128 specific 
ublication. For the scores of you who are new to Twin Cities 
128, I hope you will find every page of this issue 
enlightening and entertaining. Since our last issue, a number 
of interesting things have transpired, many of which are | 
highlighted in our Price and Progress Report. During this 
eriod we have been talking with Commodore and a variety of 
evelopers about the long term C-128 uers support plan I 
outlined in our last issue. I want to thank all of you who 
wrote to us and Commodore, in support of our proposal. I can 
tell you that there are indeed people oy your letters and 
that the plan is seriously being discussed and considered. I 
can also tell you that we have a lot of territory to cover if 
it is to become a reality. I also want you to keep in mind 
that it is a long shot, but regardless of what Commodore 
allows us to do for you, we continue to keep swinging for you! 


Which brings me to a bit of a sad note. As the 8 bit computer 
market continues to mature and software Commodore software 
producers diversify into other markets you will no doubt begin 
to notice some changes within the Commodore media. The large 
gloss magazines that cover the 64 and the 128 which depend 
argely on advertising revenue for their profit will begin to 

shink and in some cases disappear. Ahoy! was the first 

casualty of this trend. In a prime case of irony, their fifth 
anniversary issue extolling on their longevity was their swan 
song. Recent issues of RUN and Compute’s Gazette have also 
hit the newstand quite a bit thinner with higher editorial 

content to advertising page ratios. In another case of irony, 

we have strong evidence that the 128 community is continuing 
to grow. Commodore expects to sell more than one million new 
64s and 128Ds in 1989, and we are getting lots of information 
requests and new subscriptions from brand new 128 owners and 
our area on Q-link is always brimming with questions from new 
comers. | 


All of this, and the fact that we are starting to pick up some 

of the advertiser support that other publications are los 

due to our relatively cheap advertising rates has continued to 
assure us that there is indeed a strong market for all levels 

of 128 support. In this vein, as Frank mentioned, we are. 

going to continue to expand out beginning and intermediate 128 
coverage, while still maintaining a fiach profile on the 

"leading edge” of C-128 programming developments. Along thes 
lines we are also considering publishing a book entitled, "S 
C-128 Questions...Answered". If you would like to see such a 
book, or, have some ideas or “Larry on what should be 
included in such a text we would love to hear from you. 


One last note, last issue we poe in our subscription mailing 
method from 1st to 3rd class within the US. This cutour 
mailing costs a whopping 80%! However there were a few minor 
difficulties. The post office told us that our subscribers 

should receive their issues within two weeks. While most of 

our readers who access Q-link told us they received their. 
issues within two weeks, we did learn that for some readers it 
took as long as four weeks. We also learned that the post 

office does not forward third class mail when people have 
moved, so if you are moving in the near future, pre be 

certain to send us your new address immediately! As always, 

if you suspect you have missed an issue please write us. Be 

sure to include your name and address information, plus a 

phone number where we can reach you. 


EE | Sign Oost 


(I a a | 





by Frank Hudson & Loren Lovhaug 

ce 1750?...For those tired of stalking the 
elusive expansion unit, this spring brings news of two 
new sources for 512K REU’s so vital for GEOS, C-128 
productivity, and CP/M users. Several sources have reported 
availability of genuine 1750 RAM expansion units during 
March from Sears. Those who have found them at the stores 
say that Sears new lower lee retail strategy extends to 
the hard-to-find 1750, with a $180 price being reported by 
one Minneapolis shopper. Another report says that Sears 
still has a valid catalog number (3 A 3 - for this item 
and that as of this February they were available for 
$199.99. I doubt Sears’ stock of 1750’s is very deep, so 
there are no guarantees you'll bag a REU by the time you 
read this. Sears, where America shops for expansion memory? 


Software Support International has cleverly found another 
route to meeting the 128 owners REU needs. They’ve bought 
up a batch of the 256K 1764 units meant for 64 users and 
then installed additional RAM to bring them up to full 1750 
status. Each cartridge is tested and warranted to be free 
from defects. Their price for this "1750 Clone" is $199.95, 
and considering the amount of hand work that goes into such 
a conversion, it’s a bargain. Have a 1764 hanging around 
that you’d like converted to $12K? SSI will do that for 
$124.95. Wonder what they’re doing with all those extra 
heavy-duty power-packs that Commodore ships with the 1764 
(the 64’s power su ply, unlike the 128’s, isn’t up to the 
addition of a REU)! For $29.95 your C64 using friends can 
pet one of the excess power supplies from Software Support 
nternational. Software Support International 2700 NE 
Anderson Rd, Vancouver, WA 98661 (800) 356-1179. 


BASIC 8 available again... By the time you read this Free 

Spirit Software Inc. will have entered into an agreement 

daar beads Software Inc. to eee BASIC a the popular 
graphics programming system for the Commodore 128 computer 
written by Lou Wallace and David Darus. d 


BASIC 8 is a programming environment for the Commodore 128 
fs 128D) computer in 128 mode with 80 column graphics 

splay. BASIC 8 adds over 50 new graphic commands to 
standard C128 BASIC. BASIC 8 allows 640x200 resolution in 
monochrome and 640x192 resolution in 16 colors without any 
additional hardware. BASIC 8 even permits drawing in a three 
dimensional environment. Command: are qiclided tor windows, 
fonts, patterns and brushes. A RunTime Library, which 
oo a ams written with BASIC 8 to run without BASIC 8, 
is included. 


The version of BASIC 8 to be published by Free Spirit has 
been revised and Rance The package includes a two disk 
set containing the BASIC 8 language, RunTime library, 
demonstration programs such as BASIC Paint, BASIC Calc, 
BASIC Write, utilities and a new 200 page instruction 
manual. The list price for BASIC 8 is $39.95. 


If had a Hammer...Free Spirit Software Inc. has also 

released a package called "Basic 8 Toolkit", a utility 

i at for use with the Basic 8 hi-resolution graphics 
evelopment system for the Commodore 128 computer. The 

Basic 8 Toolkit features a point-and-click operating system 

that allows the user to create custom Pointers, Fonts, 

Patterns and Icons. The Toolkit also allows the user to 

convert Print see: Graphics into Basic 8 graphic files. 

Colors may be added to the Patterns, Icons and Print Shop 

Graphics with the color option. The Toolkit also contains a 

set of useful disk utilities such as make autoboot, convert 

icon file to brush file, scratch file, rename file, validate 

disk, toggle drive, directory and format. Files created 

with the Basic 8 Toolkit can be used in custom programs, 

Basic 8 programs or with erapue programs such as Sketchpad 

128, Spectrum 128 or News Maker 128. The Basic 8 Toolkit is 

available from Free Spirit for $19.95 
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Does Whiz Kid Ever Sleep?...Poster Maker 128 allows the user 
to create large posters ranging in size from two foot by two 
foot to five by five feet (25 pages!). The ec may be 
pres out or saved to disk as "picture files". Poster 
aker 128 includes a graphic utility which permits it to _ 

import BASIC 8, Sketchpad 128 or Spectrum 128 pape files. 
These graphic files can also be enlarged on both their X and 
Y axis. Also included is a utility to reduce the size of 
grape screens in order to create clip art. Poster Maker 

28 operates on the Commodore 1 or the Commodore 128 
with upgraded 64K Video RAM in 80 column 128 mode. 
Resolution is 640x200 pixels. A 1351 or compatible mouse 
and a 1571 disk drive are required. Optional support is 

rovided for a 1571 or 1581 disk drive a second drive. 

oster Maker 128 has a supe sted retail price of $29.95. 
Free Spirit Software Inc. P.O. Box 128, 58 Noble St., 
Kutztown, PA 19530, (800) 552-6777. 


Missing in Action...As of date we still have not seen a 

finished copy of the now eeeneay 100% assembly language 
paint package from Walrusoft or Pocket Writer 3. Our spies 
tell us the Pocket will not see daylight until May, while 
Walrusoft Paint is near completion, but in a holding pattern 
as a result of the puss anDe egal tangles between 

Walrusoft and Patech, the former distributors of BASIC 8. 
Meanwhile we are sending out search parties. 


On the Homefront...As the popularity of Twin Cities 128 
continues to escalate, we find ourselves in the 
uncomfortable position of not being able to fill requests 
for some of our back issues. Unfortunately (or as our 
accountant says, ornate we have sold out of all of our 
issues except a limited supply of issues #4, #19, #20, and 
#23. To fill the demand for many of our earlier issues we 
have created the Twin Cities 128 Compendium Book #1 which 
contains the best material from our first 16 issues. This 
175 page collection sells for $16.95, We most definitely 
will be creating a second compendium book in the future, 
however, for those who simply can not wait we can send you 
hotocopies of any article we have published. Just send 
53.00 for the first article and 50 cents for each additional 
article to: Twin Cities 128, P.O. Box 11578, Minneapolis MN 
55411. Also, again as a service to our readers, we are | 
offering all the programs from this issue on a disk for just 
$5.00 which includes postage and handling. 


Overheard...According to Les Lawrance at Software Support 
International, they are very close to creating a utility 
that will allow GEOS 128 v2.0 to boot off of a 3.5 inch disk 
while fully protecting Berkeley Softworks from those who are 
silly enough to endanger C-128 development through software 
theft. Meanwhile, for the last couple of weeks we have had 
the luxury of playing a full featured terminal package which 
runs under GEOS 128 and GEOS 128 v2.0! Geoterminal 128 
includes a 30K buffer, Xmodem, XmodemCRC, and punter file 
transfers, 300 and 1200 baud support, a built-in GEOS to PRG 
or SEQ and vice versa file converter, and a fully 
configurable autodial phone book! This work of art was 
written by GEOS programmer first-class Bill Coleman aka 
Master Blaster and will be sold on the upcoming second GEOS 
productivity package from RUN magazine. On other front, our 
informants tell us that sometime later this spring Free 
Spirit will be eee sy whole series of ne. quality clip 
art disks for the 128 in BASIC 8 format, and something truly 
original: a clip sound collection and a basic wedge that 
will allow you to incorporate life-like digitized sounds in 
our own C-128 programs! Lastly, we keep hearing that a 
amous florida fo 128 master programmer is very close to 
completing a pre-compiler system that will allow BASIC 8 
programs to be compiled with Abacus software’s BASIC 
compiler. If this pans out...look for a flood of super fast 
128 graphics software! 
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” 1541 RAMBOard* - MAVERICK ™* 


Byte The Copy Protection bullet! A New Tool-From Some Old Friends 

Let's face it - war is hell. And in the Commodore world, one You know us. When copy protection began throwing 1541 drive heads out of alignment. we gave you Kracker Jax. When V-Max’ reared 
of the ugliest wars of all is being waged by the copy protection its ugly head. we created the Kracker Jax Elite series. When the copy protection wars escalated. we responded with Bull's-Eye and the Hacker's 
industry. They're tough. They're clever. And they're very, very Utility Kit. And when you decided to explore the mysteries of commercial-grade protection schemes, we were there with Kracker Jax Revealed. 
determined. If you've seen some of the current ice out there, Now the copy protection industry has upped the ante again. They ve made it harder than ever to make legitimate backups of your expensive 
you know just how determined they are. Well, we're just as software. Do you think you should have to spend money to buy “authorized” backups of software that you already own? 
determined. And we've got a way to walk right through the Neither do we . . . 
coldest ice out there. Introducing Maverick. the best weapon we ve ever made to let you defend yourself from copy protection profiteering. Maverick is so advanced, 

What's our secret? The new RAMBOard. a small card that it has actually replaced every other backup utility we ve ever created. That's right - Maverick is now the ONLY archival software we manufacture 
can easily be installed in your 1541 in 5 minutes using just a All of our R&D efforts go into making sure that Maverick remains the most powerful backup utility available - from ANY source! Take a look 


screwdriver. With this remarkable piece of firmware in place, at some of these features 
backup hassles are a thing of the past! NEW — 1541 1571 1581 tast file copier - any direction 
RAMBOard gives you speed - it comes bundied with a fast CP RCHOL ORIG SAD e Teneo nak’! 
copier that can archive an unprotected data disk in under 60 ee BEOS ne ee 
seconds. RAMBOard gives you power - working with our Hiecionpeditol beliovcU Baa gsuedke 
eee ee Gn ee eign Hee Works with C-64 C-128 & 1541 1571 1581 drives NEW —- Dump a formatted parameter catalog to printer 
u 


Scrolling M t monitor with Drive Mon Byte pattern scanner for high speed searches 
all, RAMBOard won't become obsolete - when newer, even e EXLUSIVE Popular subscriber service available e Technical support from our staff experts 
tougher protection schemes come along, we'll create new And this 1s just the beginning Our future plans for Maverick include expanded RAMBOard support, RAM expansion module support. and even 
Maveric/RAMBOard parameters to cut right through them. a 1541 1571 1581 relative file copier! And with our unique Subscriber Program. you can receive Maverick updates automatically - the instant 
Backed by our famous R&D, you know that we'll do whatever they re released! 
it takes to keep RAMBOard operating behind enemy lines! You know us. We re the company that has worked hard for years to establish an ironclad reputation for dynamic products. fair prices, and 
Get your RAMBOard today. And the next time some com- 


superb customer support. We ve always been a part of your past. And as long as you have your Commodore, we ll always be a part of your future. 
pany tries to charge you for an “authorized” backup of a prog- 


ram you've already paid for, remind them that war |S hell - Attention: Registered Maverick owners! MAVERICK 2.0/ON LY $34.95 


and you know how to raise a little hell of your own. , . / 
; : Parameter Module #3 is now available, Only $9.95 Now INCldES arainelel MOQUIES 1) 6 oF: 


1541 & 1541C RAMBOard/ONLY $34.95 *Maverick Was Formerly Known As “Renegade” From Kracker Jax 


In Most Cases, Plugs Right In-NO Soldering Required Not To Be Confused With The Game Of The Same Name 
154111 RAMBOard/ONLY $44.95 : : OES SEE ONCE SOLE SEES SEEMED 


This Version DOES Require Soldering THE 1581 TOOLKIT 


Profesional Installation Available-Contact Us For Details ; ; 
*RAMBOard is An Optional Accessory For Use With Maverick” JE Without It, You Don't Know What You 1581 Is Capable Of 
It blew people away at the “World Of Commodore Show” held in Pennsylvania in November 1988. It's power 
and scope astonish anyone who sees !t work. And, if you have a 1581 drive, it is the single most important piece 
of software that you can own. It is The 1581 Toolkit-and it will transform your 1581 into something remarkable. 
We know the market, and we know that if you've bought any other 1581 utility in the past, you ve probably been 
disappointed. But while other companies rushed ill-conceived and poorly executed products to market to “cash in” 
on the new 1581 drive, we did things differently. Our programmers took the time to become experts on the 1581 
before they even looked at a drawing board. So when they finished the Toolkit project a full year later, they had 
accomplished what no one else had - the creation of a tight. integrated package of essential utilities that make 
the 1581 more than the sum of its parts. Take a look at these Footkit utilittes and see why we re so excited about it: 
e - Disk oe e@ Fast File Copier @ Track & Sector Editor 
@ Directory Editor @ Byte Pattern Search @ Error Scanner 
Thanks For The Memory @ File Track & Sector Tracer e Ultrafast Formatter e Relocatable Fast Loader 
Most Commodore users are content to use their computers @ Partition Creator 
within the constraints placed on them by a limited amount of ‘ All 10 of these custom utilittes use extremely fast read:write routines. Wherever appropriate, they allow full 
RAM. But some people want more. More speed. More power. access to partitions. It's obvious we created The 1581 Toolkit to be the finest set of utilities available for the 1581 
And that means just one thing - more memory. drive. But we didnt stop there. Order now, and we'll also send you the 1581 DOS Reference Guide FREE! With 
Power users have long known that the ideal solution to their ey pages of concise, valuable information, you'll quickly find this book indispensable! Written by David Martin 
memory problems is out there in the form af Commodore's ( agazine's Copy Corner reviewer), this manual represents a year's worth of research and investigation 
Site A750 AMA eapane on GRGTtiGs au Sa liGaL anand into the inner workings of the 1581 drive. We've also added extra utilities, including such handy items as a machine 
incre p plug language monitor with DriveMon, the perfect companion for the 1581 DOS Reference Guide. 
youve got a whopping 512k of onboard RAM - the same We've spent a lot of time working hard to make sure that nobody knows more about the 1581 than we do. Don't 
amount of memory found on most IBM computers! This is the sell your 1581 short. Get the 1581 Toolkit today, and let us show you just what it’s really capable of. We'll take 
memory cartridge that all serlous Commodore power users your 1581 absolutely as far as it was designed to go. And then we'll take it farther. 
want. There's only one problem. 


youlcaneinaiher: THE 1581 TOOLKIT (ON 3.5” DISK)/ONLY $39.95 


That's right. These RAM units are almost impossible to buy. Includes Your FREE 1581 DOS Reference Guide 


We've always specialized in finding solutions to Commodore °,7 
felated problemis.< here siwhal we camesup Wilf: es The 1581 Toolkit Works On The C-64 Or The C-128/C-128D In The 64 Mode 


First, we bought brand new Commodore 1764 RAM expan- 
sion units. the ones with only 256k of RAM onboard. Next. we 


had Chip Level Design engineer and produce a custom up- = ATTENTION C-128 OWNERS 
grade that takes a 1764 to a full 512k! That's the same half Solderless 64K Video RAM Upgrade COMMODORE 


meg of RAM as a regular 1750! Finally. we tested each and Now that Commodore has released the C-128D with 


every Cartridge. and warranteed them to be free from defects. P 64K of video RAM. we should be seeing 128 prog- 
Now there's nothing to stop you from taking your Commo- KC] rams address this fantastic new feature soon ° HEAVY-DUTY 


dore 64 or 128 to levels of power and sophistication that the BASIC 8 already has the capabulity of using all 64K "e 

original designers never even dreamed of! If you're using prog- of video RAM If you own the C-128 es condi- fon POWE R SU PPL| ES 

rams like GEOS from Berkeley: the Pocket Series from Digital tion. you own all 16K of video RAM that Commodore e ; 

System IV from Professional Software; or the potent PaperClip full 64K of video RAM provides you _ bs ability OR Sorry about that. Actually. it’s no laughing matter. Our tech- 
Il] from Batteries Included; if youre using ANY of these prog- to scroll through video memory as well as enhanced moet nicians tell us that the majority of Commodore computer prob- 


rams, you wont believe the difference that the extra memory Color TESoiution sesete lems can be traced back to an inadequate power supply. When 


“| K of owe 
makes! e RAMU eae hee oe NRE Saoe the power supply fails, it can (and often does) cause additional 


*C-64 64c (but NOT C-128 128D) owners MUST buy a heavy- 83] and install the parts What a hassie! no joke. 
oy soba eae to re units. The Sesh supply is SOLUTION — We have developed a module that ; This doesn't have to happen to you. We are now selling a 
INCIUGED “LIS avaliable iFOM US Seperately. ly plugs in to the mother board of your C-128 . imini 

"If you ALREADY own a 1764 RAM cartridge, we can upgrade OO Nia’ eolatioved aoe hohe deinge No : heavy-duty power supply that will greatly diminish your fear 
i of a power supply failure. These are NOT aftermarket units - 
it for you. Your unit MUST be tn perfect working order for us hassle. 4 aeait th RAM 
to upgrade it. The turnaround time on upgrades is approx. 2 This package 1s available in two different forms they are made by Commodore, and are ideal for use wi 

weeks. It will NOT be necessary for you to purchase a new Model A has all parts necessary to complete your expanders. They will provide you with a more stable, depend- 
power supply - the one that came with your 1764 will still work upgrade. and Model B is identical except that you able ee of power. This unit will work on ALL C-64’s and 

64c’ on the market. 


fine. supply the RAMs. Again, no soldering is necessary ° 
THE 1750 CLONE If you have access to low cost RAMs. we suggest 2 If your system is important to you, take the extra step to 
ON LY $1 99.95 structions, a test program to verify proper installa- $ no unexpected shocks. 
tion, and the plug in Video RAM Upgrade : 
@ \) LA/ \) «, is ‘ 
SRC Ke ; “ays RISK OOOO 0% ~ 
gees aa egteteates ; PRK RRR RR aes * RKO 


Mode! B safeguard your investment by getting a Commodore Heavy- 
1764 UPGRADE Mods A compete) @AQ QE <1 COMMODORE HEAVY-DUTY POWER SUPPLY 
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Single or dual state of the art Nibbler 

300 + parameters for those tough to backup disks 
Capable of archiving Rapidick protection 

Single of duai drive high speed data copier 
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One salen eg PLEASE READ BEFORE ORDERING: We accept money orders. certified checks. VISA. MC and, Discover Mail your order to: Software Support, Int 

5 Meer AOS Previous Software Support customers may use C.O.D. and personal checks. Orders shipped to U.S.A. (48 states). 2700 NE Andresen Road Vancouver W A 98667 
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orders shipped 2nd day air). please add $7.50 per order for S & H. C.0.D. availabie to US. customers only (50 1-800-356-1179. 9am-5pm Pacific time 
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by including $4.00 (minimum charge) for the first two pieces of SOFTWARE and $1.00 for each additional piece After hours orders accepted at 
per shipment. All monies must be submitted in U.S. funds. Canadians must call or write for hardware shipping (206) 695-9648 7 days a week. 
charges. Foreign customers must cail or write for shipping charges. Defective items are replaced at no charge if Technical support available. Call 
sent postpaid. All in stock orders are processed within 24 hours. U.S. SOFTWARE orders over $100 will be shipped (206) 695-9648. 9am-5pm Pacific time. 
2nd Day Air at our regular $3.50 S & H charge (48 states only). Washington residents please add 7 6°» additionai Monday-Friday. 
for Sales Tax. All prices subject to change All sales are final uniess authorized by management Orders Outside USA call (206) 695-1393. 
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by Ray Bryan | 

he past two years I have complained so much about doing the 
taxes in slow and stupid mode on my C-128 using Timeworks’ 
Swiftax that this year I swore I would find another, better 
may ane I did. (1 concede that Timeworks is second to none 
in their customer service - they even offered my money back 
after I had filed - but I felt I must aad 2 ean just 
in case of audit; this year they have a C-128 version | 
apparently). I had seen those little adds for Taxaid in the 
back pages of those ’other Commodore magazines’ and thought 
if it is for the 64, Plus/4 and 128, how could it be better? 

Actually, there are 3 C-128 mode packages to choose from 

e 3rd is Steve Karasek, 855 Diversey, St. Louis, MO 63126 

314-961-2052, which does schedule F for farm income and 2106 
Employee Business Expenses which Taxaid will not do). 


——— 
: | 





Taxaid Software, Inc. doesn’t spend their time and money on 
Bossy ads, super salespeople and customer service support; 
the spent their time researching tax law and writing 
intelligent code. Unlike the ’name brand’ product mentioned 
above this program supports the 1571 and 1581 disk drives 
and multiple drive units e is distributed on a 5.25 inch 
floppy but was easily backed up to a 3.5 inch disk). 

ough it does not directly support the 1700 or 1750 Ram 
Expansion Unit and the manual’s recommendation that with two 
drives the data disk be in the one configured as device 8 
while the program disk is in 9, I found that it is usable 
and resides quite well in device 10 under RAMDOS. The manual 
has a caveat regarding non-Commodore printers with not 100% 
compatible interfaces, but it worked very well with my 
Silver Reed Typewriter and Micrographix MW350 interface in 
emulate mode. In short, it allows you to use the system you 
have, not contort your set-up to meet some lazy programmer’s 
idea of the lowest common denominator. 


I began by running RAMDOS from the 1581 disc drive 
(configured as device 9 in my set-up). I then used FILECOPY 
to copy the program into the Ram Expansion Unit. The manual 
states that a blank disc should be formatted before starting 

the | genie That is because Taxaid provides no means to 

send disk commands to the drive other than load and save 

during its operation - a program called FORMAT is on the 

disk, however and can be used in between modules. I also 

tried Taxaid with the Ram Expansion Unit as device 8 and 

used FILECOPY between running the modules to save the data 
to the real drive. Using RUN'"filename"onU(drivenumber) sure 
beats the pants off of LOAD "filename",(drivenumber) and 
RUN, for my money. (On the 1581 you can use 
RUN'"f*e"onU(drivenumber). 


The program is divided into 5 separate modules which are 
each meant to run alone. If you have a small business, _ 
income property or capital gains income (or a combination of 
these as in my wife’s and my case) you need to start with 

the separate schedules C, D or E (and SE if you have no W2 
income or need to fill out the earned income credit). These 
results must be saved and printed out to file with the main 
1040 form (you may file the printed out copy or transfer the 
data by hand to the govern a forms). The main bulk of the 
work is done in the [040 module which includes schedules A 
and B and form 2441, the childcare credit form. 


Each module starts out with a very readable, no frills menu 
from which to choose between data entry, data display, data 
changes, results display, loading or saving data, out-print 

of results or a work sheet and a quit/clear option. 

Choosing the quit/clear option brings up the only other 
choice menu with options to erase all data and start over, 
erase all data and quit or return to main menu (without 
disturbing the data). 


The program uses what the manual calls ’entry numbers’ as 
prompts that appear on the screen as (E#). The user is 
expected to enter a number and carriage-return. The program 
then asks for a specific datum. These prompt lines are all 
spelled out in the book, with a clear explanation. Any item 
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which does noi pertain to your situation, you may oP over 
by simply not typing in the E# of that question. The 
numbers do not follow the IRS forms line numbers but with 
the Taxaid manual on one side and the form on the other it 

is easy to see what data is called for and where the process 

is leading. The book is concise and to the point. The 
manual suggests you print out the program work sheets to aid 
organizing your figures before you begin entering data. 


Taxaid is very casy to use and fast (peo from the Ram 
Expansion Unit) in its calculations. With taxaid it 1s very 
fast and easy to decide what options will minimize your tax 
liability, for instance, you may want to know whether to 
itemize your deductions or take the Standard Deduction or 
how a contribution to your IRA will affect the tax you owe. 
Taxaid can do this type of speculation much quicker than the 
old calculator and paper method. 


Weaknesses? Yes, it has some. No Schedule F or Form 4562 
depreciation schedule are in the program. It would be nice 
to specify a data drive other than 8, and changes onthe __ 
separate module schedules are not automatically plugged in 
to the respective 1040 lines. I was not put off by the 

entry number format but I suspect that some people would 
count it as a drawback. 


Minimizing your taxes is what is important and Taxaid can 
help with that. Taxaid is not a program to meet the needs of 
every taxpayer. But if you have any sort of complexity to 

our tax status, a child in daycare, a house andasmall 

usiness, a duplex, an even modest investment portfolio, it 
could be a great time saver for you. I am pleased with it 
and I recommend Taxaid. It costs $49.95 with next year’s 
update at $18.00 plus $2.00 shipping and handling. 


Taxaid Software Inc., P.O. Box 100, Two Harbors, MN 55616. 
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by Loren Lovhaug 

It seems like and eternity, way back in early May of 1986, I 
discovered something that radically Cuanged the way I 
produced Twin Cities 128. At that time, Berkeley Softworks 
was an unknown entity, and GEOS 64 version 1.0 was being 
advertised with very small and modest black and white ads. 

Oh how times have changed. Looking back at issue #6 of Twin 
Cities 128, and the version of GEOS I was using, it is hard 

to believe I could have gotten the results I did. Version 

1.0 of GEOS for the 64 was slow, clumsy, and bug ridden. 
There was no RAM Expansion support, in fact at the time the 
RAM eepansions for the 128, let alone for the 64, were just 

a spot of vaporware on the horizon. The only disk drive 
supported was the 1541 which meant that I could only use 
single sided disks on my 1571, leaving me with a whopping 

24K of disk space after I stripped my desktop of all 
unnecessary frills. Add to this the fact that the only 

input device support was a joystick ala the recently 

released "1350 roller joystick" and it seems like I was _ 
computing with knives and bear skins. And yet it was light 
years ahead of Doodle, which was the graphics package I used 
to render the illustrations in our previous issues. 


In those days, GEOS was the new frontier. In fact, due to 
the fact that I was fortunate enough to get my hands on the 
re-release version 1.0 of GEOS for the 64 in May of 1986, 
can safely ay that we pioneered the concept of desktop 
ublishing with GEOS, as we used it to pre uce an issue of 
win Cities 128 weeks before it was readily commercially 
available. I am happy to say that both Twin Cities 128 and 
GEOS have come a ong way since those days. But we remained 
on the cutting edge of GEOS developments for a long time to 
come. Later that summer, Commodore bestowed upon me a hard 
to come by 1750 RAM eran unit (maybe things do not 
eee and a prototype 1351 "proportional" mouse so we 
could test them with a prototype version of GEOS that 
supported these new fangled gadgets. As time marched on we 
participated in the development of GEOS by beta-testing a 
variety GEOS add ons, including extensive testing of the 
early versions of GEOS 128. Then, sadly, durin Tae fall 
of 1987, GEOS and I sort of broke company. It happened 
rimarily as a result of our purchasing our Okidata 
aserline 6 laserprinter and my fascination with BASIC 8 as 
an eee column graphics tool. Because I was never able to 
get the HP compatible laser printer drivers for GEOS to 
work, I was forced to abandon it as a tool for the 
roduction of Twin Cities 128, even though I still was very 
ond of it as a graphics and desktop publishing tool. I 
also think that Berkeley’s advertising, resplendent with 
immense gloss and hype, and some of their pricing, upgrade, 
and customer support policies (all of which show signs of 
significant improvement) also played a role in my 
disenchantment. 


During the next year, I booted GEOS very rarely, quite a 
change from the days when it was a constant fixture on at 
least one of my 128s. Then in the late summer of 1988, I was 
asked to review GEOS 2.0 for the 64 for RUN magazine. 
Through my explorations I could see that Berkeley had come 
along way as far as GEOS development was concerned. Sure 
there were things I did nitpick about, as I will later in 
this article but, overall, GEOS had finally evolved into an 
operating system worthy of all the Bype surrounding it. In 
my mind, only two pieces of the GEOS puzzle were now 
missing. First and foremost, the porting of this greatl 
enhanced version of GEOS to the 128, and secondly the 
support for my HP compatible laser. Two weeks ago those 
uzzle pieces arrived. And ever since, GEOS has again 
ecome a fixture on one my 128s. Forgive me for this poetic 
metaphor, but it does indeed feel like a long lost friend 
has returned. I assure you this friend is not perfect, mind 
you, however, I have never felt better about recommending 
GEOS to 128 owners than I do now. 


GEOS 128 v2.0 comes on three double-sided 5.25 inch floppy 
disks. Unfortunately the boot disk for GEOS 128 v2.0 is 
copy protected, unlike the latest release of GEOS for the 
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Apple Ile which is not, even though the packages are nearly 
identical in scope and content. Apparently Berkeley has 
decided that it can "trust" Apple IIe owners but not | 
Commodore 128 owners when it comes to software piracy. 
This decision is particularly ironic when one considers the 
fact that the Apple II community is notorious for hea 

software piracy, particularly in elementary and secondary 
schools eee Apple computers are so predominant. My own 
observation of the Commodore 128 community is that as a 
whole, Commodore 128 owners are far more likely to purchase 
acommercial productivity title like GEOS 128 v2.0 than 
either the Commodore 64 owners or Apple II owners, To 
Berkeley. s credit, they have included a backup copy of the 
boot disk, just in case your primary boot disk fails. 
Berkeley also will replace failed boot disks for a nominal 
charge to registered GEOS 128 v2.0 owners. 


Also included with the package is not one, but two manuals. 
The first is a perfect bound 307 page copy of the GEOS 64 
v2.0 manual. As software manuals go this one is actuall 
very good, and a nice improvement over eet ls GEO 
documentation. The manual sports a table of contents, an 
index, a generous number of illustrations, and is organize 
in a logic ee from initial use to ee by step | 
instructions detailing the usage of the GEOS application 
programs. The second manual is a 106 page stapled "GEOS 128 
v2.0" Addendum. While this manual shares the nice touches 
of the primary manual it is unfortunate that Berkeley did 
not make an attempt to integrate its material into the 
primary manual as their organization 1s snl hectare 
As it stands, I find myself bouncing between the two manuals 
as both contain valuable information. Another nitpick I 
have about the manuals is that the perfect binding of the 
primary manual and the stapled binding of the addendum do 
show a lot of wear after moderate usage. It is a shame 
Berkeley did not see fitto bestow upon usthe same 
loose-leaf, three-ring binder and slipcase, resplendent with. 
tab index dividers that accompanies Apple GEOS. Again, it 
appears us Commodore types get second class treatment, even 
ough recent price cuts in ete GEOS put its pricetag in 
the same ballpark as GEOS 128 v2.0. 


The enhancements to GEOS 128 can be divided into the 
following categories: desktop enhancements, geopaint 
enhancements, and geowrite enhancements. 


Desktop Enhancements 

In my opinion, the enhancements to the GEOS 128 desktop are 
the most significant of the version 2.0 enhancements. As 

in the original GEOS 128, Berkeley fully supports the 1541 
1571, and 1581 disk drives as well as the 1764 and 1750 RAM 
Expansion units. However, the addition of support for an 
additional mass storage device, bringing the total to three 

is quite significant. This means that owners of two disk 
drives and a RAM Expansion unit do not have to sacrifice the 
use of one of these drives or go through the tedious 

process of constantly reconfiguring GEOS in order to 

utilize all of their equipment. Although the addition of 
support for a third mass storage unit is a big improvement, 
the way in which this support has been added 1s a tad 

clumsy. You see, as with GEOS 64 v2.0, you effectively only 
have access to two devices at any give time, labelled units 

A and B, while the third device unit C, lies dormant. In 
order to access the device C, you need to swap one of the 
two active devices, A or B, with unit C, thereby making 
device C active and one of the devices A or B inactive. | 

This "shell game" can be peagare buen ee by either dragging 
the icon for device C up into either the A or B device slot | 
or by holding down the Commodore key and shift A or shift B 
to swap the respective device on the "on deck circle". 


As was hinted at in the previous sentence, Berkeley has 
added a number of keyboard shortcuts for operations. 


Continued on Page 7 
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Continued From Page Six 

This keyboard supports allows those people who don’t fancy 
themselves as "mouse jockeys” to navigate GEOS in most 
instances without lifting their fingers from the keyboard. 

To ena s credit, many of these shortcuts are mneumonic 
in nature. In another very nice piece of Berkeley insight 

is the placement of a date and time read out on the desktop 
and a provision for setting the date and time from the 
desktop. Under previous versions of GEOS the clock could 
only be set from the preference manager. The end result is 
that very few GEOS owners took advantage of the time and 
date cere gee features of GEOS because of the tedium 
associated with setting the clock and the fact that the 
preference manager was often considered "expendable" when it 
came to freeing disk space for other purposes. 





But perhaps the most important improvements incorporated 
into GEOS 128 v2.0’s desktop are its new file selection 
facilities. To begin, files may now be selected not only 
from the "icon" view mode, but in fact from all of the text 
e view modes as well. This means that if you want to, 

or instance, chose a number of font files to be copied to 
your RAM disk, you can quickly do so instructing the 
desktop to dis fay the files on your disk by Oke and all 
of your font files will automatically be groupe together 
making the selection and copy process much easier, in 
addition the file sizes are displayed as well which really 
helps when you are trying to cram those final couple of 
files into tight disk space. But the file selection 
enhancements to GEOS 128 v2.0 don’t end there, GEOS 128 
v2.0 now allows you to select multiple files for all file 
operations such as file copying, renaming, deletion etc. 

ultiple files can be selected in a number of ways: by 

holding down the commodore ap hoe clicking on the filenames 
or icons of your choice, or by holding down the commodore 
key and pressing any of the numbers 1 through 8 which 
correspond to the filenames or icons currently being 
displayed on the desktop, or by utilizing the menu items (or 
their keyboard shortcuts) for selecting all files on the 

disk, desktop page, or those files on the desktop border. 
Clearly these new options make it much easier to conduct 
routine file maintainence on your GEOS disks. 


Geopaint Enhancements 
In my opinion, the best reason for using GEOS has always 
been geopaint. Geopaint has always been one of the 
strongest drawing packages available for the 128 because it 
features a high level of sophistication combined with 
assembly language speed. Additionally, Geopaint is one of 
the few graphics programs for the Commodore 64 or 128 which 
is actually page oriented as opposed to screen oriented (see 
my discussion of these considerations in issue #16 of Twin 
Cities 128). As with the original C-128 version of Geopaint 
the GEOS 128 v2.0 version of Geopaint functions on either 
the forty or 80 column display, however color is only 
Peet on the forty column display. This is indeed 
ortunate. As readers of Twin Cities 128 know, over the 
a year some incredible strides have been in the realm of 
column graphics on the 128 and it is hardly a "big trick" 
anymore to get color bitmaps on the 80 column display, even 
on "flat" 128s equipped only with 16K of video RAM. Takin 
this point one step further, just imagine for a moment how 
nice GEOS 128 v2.0 would have been if it supported the 
extended video RAM of the C-128D and upgraded flat 128s. 
C’mon Berkeley...we have published all the technical data 
for you! We know your programmers are bright...let’s see 
more sophisticated 80 column support in GEOS 128 v3.0. 


On the plus side however, Geopaint has been greatly 
improved. The litany of improvements includes: support of 
the cursor keys for pixel by pixel motion (a fantastic boon 
when working in pixel edit or zoom mode), a special 
"constrain" mode for most drawing tools which inhibits stray 
motion when trying to draw straight or diagonal lines, 

limited grid line support, much faster and more flexible 
system for region window movement and re-sizing, additional 
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pattern draw modes, and virtual image resizing and 
rescaling. While all of these features are welcome, the 
most impressive by far are the last three. 
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The new region movement and resizing really make the 
cutting, copying, and replacement of image data and "photo 
scraps’ much easier. Under this new system whenever you are 
working with the region selection tool, (the outline box 
with the dotted ines) you are allowed to click on one of 
two control gadgets located on the upper left. and lower 
right corners of the outline box. The gadget in the upper 
left corner allows you to move, copy, or relocate your 
selection area, while the gadget in the lower right corner 
allows you to re-size the area. Through the addition of 
these two relocation and resizing gadgets Berkeley has 
eliminated a lot of the tedium Geopainter’s that used to be 
associated with cutting or placing graphic data precisely. 
Gone are the days when it was a matter of constantly 
redrawing the selection box until you got it just right. By 
using these gadgets, subtle adjustments are much easier. 


The new parere draw modes make it a lot easier to do 
texture, shading, and lighting effects. These modes are 
active when you use the paint brush or the air brush tools 
and allow you to render using patterns normally, or 
affecting only the foreground (black), or the background 
(white), as well as using the bit pattern normally or 
inverted. With a little practice and insight, the results 
can be very professional looking indeed. 


Finally, the new virtual image resizing and rescaling 
features of Geopaint are phenomenal. Essentially you can 
cut or load any image data as a photo scrap and paste it 
into any size area and the program gives you the option of 
having that image automatically stretched (or shrunk) to fit 
the area you define. In addition you can have the image 
scaled so that the horizontal and vertical aspect ratio 
remains in tact or even have the image smoothed. Also you 
can overlay the image "transparently" so that whatever is 
behind your image remains in view or place a fill pattern 
automatically in the background. I can honestly state that 
these the most sophisticated image cut and paste options I 
have ever seen in an eight bit paint program. 


Geowrite Enhancements 
GEOS 128 v2.0 includes the enhanced version of Geowrite 
which was formally marketed as Geowrite Workshop 128. I 
applaud Berkeley in their decision to include their best 
version of Geowrite with the system. In reality the 

inclusion of a bare-bones version of Geowrite with the 
original GEOS 128 did nothing but frustrate and anger C-128 
owners, especially since 128 owners have numerous lirst rate 
word processing choices. And given these choices, it is 

pretty hard to recommend even this version of Geowrite as 
their primary word processor. Text entry and reformatting 
when inserting is terribly slow and its ruler based mouse 

only approach to margins, while being visual and easy to 
comprehend, is also cumbersome when trying to create complex 
text formats such as outlines. 


However, as a secondary word Prog 6 program, especially 
for certain situations it can be quite useful. Geowrite’s 
two major strong points have always been its proportional 
font support and the ease by which graphics canbe | 
integrated with Geowrite text. The placement of graphics in 
a document is as simple as agjUsune margins and selecting 
the paste graphics command. In addition, Geowrite has 
wonderful si port for multi-line headers which can include 
aphics which are perfect for things like company logos. 
ecause of these strengths Geowrite has always beena | 
superior "printout" or “desktop publishing" word processing 
ackage. What I mean by this is that it is not unusual for 
Commodore 128 owners to compose text in another word 
processing package such as Paperclip, Pocket Writer, or the 
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Write Stuff and then transfer their text to GEOS for 
formatting, graphics inclusion, and printing. This type of 
Geowrite usage is further enhanced with GEOS 128 v2.0 by 
virtue of the fact that the Text Grabber program which 
accomplishes the conversion of alien word processing files 
to Geowrite is also packaged with this upgrade. 


Also packaged with GEOS 128 v2.0 is the Paint and Overlay 
drivers which originally appeared with the Writers Workshop 
128 product. These drivers add an incredible amount of 
flexibility to Geowrite. Essentially what they allow you to 

do is "print" a Geowrite document to a Geopaint file. This 
can be accomplished in two ways. The "paint" driver simply 
transforms a Geowrite document into a Geopaint file. Like 
the paint driver the overlay driver creates a Geopaint file 
from a Geowrite file, but the overlay driver does something 
unique. It allows you to create very complex Geopaint files 
by overlaying multiple pages of a Geowrite document. Using 
this technique you can create easily create multi-column 
documents. As an example, my mini-two column flyer on the 
front cover was created using this technique. 


As an added bonus, Berkeley has seen fit to include Geomerge 
and Geospell with GEOS 128 v2.0. Of course most C-128 word 
processing packages include support for mail merge 
operations and pee checking, so in reality their inclusion 
in GEOS 128 v2.0 is nothing all that earth shaking, except 
when you consider that until the version 2.0 upgrades these 
items cost GEOS owners extra. I have mixed feelings about 
all of this. On the one hand I am glad that serious GEOS 
users will no longer have to spend extra to get the kind of 
facilities that come as standard options with other 
packages, but I can’t help but feel sorry for those folks 
who did buy these facilities has add-ons or wonder how I 
would feel if I had spent the extra $50 - $60 it used to 
take to get these programs, now that these applications are 
standard with the system. Of course, those people who did 
purchase these add-ons did have the luxury of making use of 
them a lot sooner than the rest of us. As for the 
performance of Geomerge and Geospell, they do what they are 
supposed to do and and operate quickly. The only remarkable 
features of these two standalone programs are the fact that 
promers is capable of some very sophisticated conditional 
Scie programmable) mail cad he and the fact that 
eospell does have a very good word lookup/suggestion 
aoe somewhat of a rarity on ay Also included with 
GEOS 128 v2.0 is Geolaser which allows you to print out your 
Sees and Geopaint documents to postscript laser 
printers. 


Conclusion 

I am sure that very soon you will be seeing a lot of reviews 

and opinions on GEOS 128 v2.0. I am equally sure that none 
of them will be as tough as I have been. I want you to know 
that despite epee of a candid commentary and nitpicks, I 
think GEOS 128 v2.0 is a fantastic aera to the original 
version of GEOS 128. This version has made using GEOS fun 
again for me. While I can’t say that GEOS is for everyone, 

I can say that I think many pope including GEOS skeptics 
will truly enjoy this version of the package: For people 
interested in graphics, desktop publishing, or just an 
alternative way of uae their 48, I think GEOS is money 

well spent. I am hopeful that Berkeley will continue to 

develop and enhance this product so that it encompasses some 
of the 128 developments of the past year as well as continue 

to develop add on GEOS applications. 


GEOS 128 v2.0 REVIEW 


GEOS 128 V2.0 TIPS: 
1. Using a RAM Expansion Unit with GEOS 1s a marae 
Typically GEOS users load up their RAM Expanders at the 
beginning of a session with the applications, fonts, and 
data they will be using. In previous versions of GEOS you 
were restricted to either copying a whole disk or single 
files at a time. GEOS 128 v2.0 allows you to batch | 
a) copy multiple files to the REU at one time. 

lowever, even with this new capability it is still easier to 
diskcopy a pre-set REU disk to the REU. To do this, create 
a work disk you designate as your "REU loader". This disk 
should be a 5.25 inch disk rather than a 1581 disk. GEOS 
will not allow you to do a “diskcopy" from a 3.5 inch disk 
to the REU as the maximum available storage on even a 512K 
REU is far less than the capacity of a 1581 disk. et ae 
or copy files onto the disk so that the icons for your GEOS 
application programs are on first page(s) of that disk, 

en starting on a new page put your favorite fonts (if you 

are like me you will have several pages of fonts), then on 
the last page(s) of your disk place the desktop, the RAM 
Reboot file, your printer driver, the paint and overlay 
drivers and your desired desk accessories. Then use the _ 
page apeen command from the deskop’s page menu to insert a 
new (blank) page 1 on your saris Likewise use this 
command to insert a new page at the page where your fonts 
begin. Once you have done these steps you will be able to 
quickly pre-load your REU via the diskcopy command. 


Here is why: Essentially what we have done is placed all of 
the files you normally need to double-click on from the 
desktop on the frontmost pages of the desktop so that you do 
not have to scroll around in search of them. Putting all of 
your erences programs together makes it much easier to 
switch between programs "on the fly". Because the first 
page is blank, GEOS will automatically place the icons for 
the subsequent application data you create or copy to the 
REU on that first page. This is convenient since you can 
double click on the application data icon(s) to. 
automatically execute a particular application with your 
data loaded in it. Creating a blank page at the beginning 
of your font data makes it simple to change the fonts your 
ap lications "see" within the REU. GEOS applications are 
able to make use of the first eight fonts stored on a dis 

or REU. By leaving a blank page before the start of aous 
font files, au can easily move a font file that is store 

on your REU after the first eight font files into that 

"front eight" by placing it on the blank page at the | 
beginning of the font files. Lastly, by putting the printer 
drives, desktop, the RAM reboot files and the desk | 
accessories on the last pages of your REU you effectively 
"moves them out of the way” since these files ones that you 
do not normally utilize by double clicking them from the 
desktop. Desk accessories are usually started from the | 
desktop or within applications via the "GEOS" menu as 1s 
printer selection and use of the photo and text managers. 


2. One of the most tedious tasks that creeps up when using 
Geopaint is the ae of a "clipped region" or photo 
scrap. However, through creative application of the paint 
or overlay drivers and Geowrite you can save yourself a lot 
of headaches. After defining your region, use the cut 
option available from Geopaint’s edit menu to cut the region 
as a photo scrap. Then exit Geopaint and from the desktop 
install the paint driver as your "printer" driver. Now 

start Geowrite (see why I'say an REU is a necessity!). 

Paste the photo uel into a fresh Geowrite document. You 
will notice that the photo scrap will be automatically 
centered horizontally across the page according to the 
margins that are established. If you like, you can change 
these margins for different positioning purposes. Once you 
have your wap in the desired position, "print" your 
Geowrite document into a Geopaint file. An even more 
sophiscated application of this technique involves using the 
"overlay" driver to precisely position multiple images 
vertically as well as horizontally. 


If you like tips, catch Sparrow’s return on Page 25 
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by Bruce Jaeger 
.U.R.S.E. is a universal Commodore disk editor that should 
pu to rest any further need to program disk editors. 

eriod. While N.U.R.S.E. can be improved in certain areas 
(as can any program, regardless of pace , 1 can’t think of 
any disk-editor-type functions that have been left out! 


First, a couple of questions. What is a disk editor, and 
why is this one called N.U.R.S.E.? A disk editor is a 
program that lets you look directly at the contents of a 

sk (hard or lloppy): and inspect and change the bytes 
encoded on the disk directly in the original spot on the 
disk, without regard to whether they’re in a sequential 
program, USR, random or other bps file--or even if they’re 
not in a file at all, like the Commodore boot header that is 
used to force an autoboot whenever the 128 is powered up or 
reset. Disk editors are used for "un-deleting" files, 
searching for lost data on scrambled disks, changing header 
names, disassembling and breaking copy protection schemes, 


creating copy protection schemes, mo rograms or 
data, and Im sure several other things that [haven't 
mentioned. 


A disk editor usually works by loading a 256-byte disk 

sector (from the track and sector you specuy) rom the disk 
into memory, and then letting you use familiar 
machine-language-monitor type commands to change any bytes 
you wish. The sector is then saved back to the disk, in its 


original location. 


Why is this program called N.U.R.S.E.? ey had me in the 
hospital, until suddenly I took a turn for the nurse!) 

Loren and I couldn’t figure it out. Maybe it’s because you 
use if for ween bad disks--but then, I’d think you’d 
want to call it C.H.I.R.O.P.R.A.C.T.O.R. or pometaine: 
Sorry, Dave, but the Reviewers Guild Rulebook requires at 
least one paragraph of feeble humor in every review. 


The N.U.R.S.E. package is more than just a disk editor. 
Also included are the following utility programs (some with 
source code!): 


Bootsector Utility 128, for creating, modifying, or killing 
autoboot. 


Formatting the back side of 1541 disk in a 1571 drive. 
1571 error checker. 


Extramon 128; adds to the C128’s built-in monitor up and 
down scrolling of disassembles, new and revised disk 
commands, interrogate command, current print device change, 
and checksum compute. 


Basic print routines for the 64 and 128. 
Source code formatter. 
Screen dump for the 128 


Super Search and Recover (an automated disk fix-up program 
for disks you’ve quick-erased by re-headering without giving 
an ID number). 


Lots of miscellaneous auto-booting and machine-language 
loading routines to use in your own programs. 


Much of the above doesn’t even have much to do with "Disk 
Utilities,” but it’s sure nice to see them "gratis" on a 

disk. It’s nice to get more than you paid for, rather than 
less,m for a change. 


But back to the N.U.R.S.E. disk editor. I sure wish that I 
had had this program a year or so ago, when I had to recover 
lots of lost files from source file disks trashed by the 
non-compatibility of 1541 disks and the 1571 drive with the 
original ROMs. I had to make do with a magazine type-in 
disk editor, and it would have been a heck of a lot easier 
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with N.U.R.S.E.. Just look at the information you get when 
you first load a sector: 


A character-type dump of the 256 bytes. This is the main 
display, and it makes it easier to read the text located on 
the disk. Unprintable characters are designated with a 
reverse space. 


The POSITION of the cursor in this block of 256 characters. 
(This is a number 1 to 256). 


The HEX value of the byte the cursor is over, and of the 
eight bytes following it. 


The DECIMAL value of the byte the cursor 1s over. 


The machine-language DISASSEMBLY of the byte the cursor ts 
over, starting with that byte. (Ifthe cursor is located 

over a byte in the middle of an instruction, this could be 
nonsense, of course.) 


The type of drive, DOS version, current track and sector, 
and the sector link. 


If you can remember all the things that N.U.R.S.E. can 
do--and remember the key commands to do them--you’ll find 
that this editor beats the eggs out of the rest. A help 
mode prints information about every command key (assuming 
you can remember which key you press to get the command you 
need help with!) Like all the best and most powerful 
rograms I’ve seen, you have to invest some time 1n order to 
earn how to use all the features. 


Every Commodore disk drive ever manufactured is Pe 
even drives 0 and 1 on dual drives, and all disk devices & - 

11. You can dump a sector printout to any printer, on the 
"regular" print device #4, and including device #5 (used by 
many parallel-port print interfaces) and the "plotter" 

device 6. You can oes in changes 1n decimal, hexadecimal, 

or (hurray!) text. (Finally, no more having to remember how 
to type in "4E" to change a byte to a capital "N".) 


N.U.R.S.E. lets you do memory fills, ANDs, ORs, ads, 
subtracts, and XORs with any value, and you can do search 
and replaces--with wildcards. You can copy sectors to 
another disk, or to a different sector on the same disk. 

You can follow a file from sector to sector, or place the 
cursor over a line link in the directory, and jump to the 
start of that file. 


I realize I’m jumping from feature to feature, and there are 
a lot of them. The manual covers everything quite well, and 
will explain for you that "line link" stuff mentioned in the 
previous paragraph. 


Here’s something neat. I hate the colors that N.U.R.S.E. 
comes up in: icky shades of dark blue that are hard to read, 
and other shades of blue/cyan that smear a lot next to them. 
But N.U.R.S.E. lets you change those colors, and in an 
interesting way. You don’t load a "change preferences" 
screen, which the program then has to load each time it 
runs, but the manual shows you step-by-step how to use 
N.U.R.S.E. itself--and many of its more advance 
features--to directly modify the color settings in 
N.U.R.S.E.. This gives you an interesting, hands-on 
practice session that actually does something useful! How 
many of you have skipped over "tutorials" that in the end 
are merely nonsense typing sessions? 


Don’t worry about wrecking your only disk. N.U.R.S.E. isn’t 
copy protected, and you’re encouraged to make backup copies 
and keep the original in a safe place. 


Continued on Page 10 
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I do have a couple of gripes about N.U.R.S.E., of course. 
Remember that Reviewers Guild Rulebook I mentioned earlier? 
nother rule is that I have to have at least one paragraph 
of petty nit-picking.) 


When N.U.R.S.E. first boots up, and when you initially load 
a track and sector, the program title "streams" onto the 

page with the characters seine koh rivers up and down and 
across the screen. This is cute. Once. After that, it 

seems to take forever. You can stop it by pressing a 

key--but you shouldn’t be put in a situation where you have 
to. I thought I'd seen the last of this stuff back in my 

PET and TRS-80 days, but I guess I was wrong. The routines 
for making aepleys e this are included on the disk for 

you to play with in your own programs. 


A more cape shortcoming is that, while N.U.R.S.E. 
automatically supports 80 column and FAST mode on the 128, 
the 80-column display is just the 40-column display 

positioned in the center of the screen. Like an assembler I 
reviewed once, here we’re paying for 80 columns, and not 

being allowed to use it. I can understand leaving the 

display the same from 40 to 80 columns, but the rest of the 
screen could have been put to better use; like a reminder of 
the command keys, for example. 


To sum it all up, N.U.R.S.E. is a feature-laden, 
well-documented disk editor program for heavy-duty Commodore 
programmers. (If you just use your 64 or 128 to play Kill 


the Icons, you don’t have much need for a disk e itor.) The 
extra programs are an added bonus. 


NOTHING LOADS YOUR PROGRAMS FASTER THAN 
THE QUICK BROWN BOX !! 


A NEW CONCEPT IN COMMODORE CARTRIDGES 








's TORE UP TO 30 OF YOUR FAVORITE PROGRAMS IN A SINGLE BATTERY BACKED 

CARTRIDGE FOR EASY AND INSTANT ACCESS! CHANGE THE CONTENTS OF THE BOX AS 
OFTEN AS YOU WISH. THE QUICK BROWN BOX ACCEPTS MOST UNPROTECTED AND 
"FROZEN" PROGRAMS INCLUDING THE ONLY WORD PROCESSOR THAT SAVES YOUR TEX TAS 
YOU TYPE: THE WRITE STUFF! THE BOX EVEN CO-EXISTS WITH GEOS, AND THE 
COMMODORE RAM EXPANSION UNITS. LOADER UTILITIES INCLUDED FOR BOTH THE 


THE COMMODORE 128. 
COMMONORE GAN? Brown Boxes Inc. 


26 Concord Drive 


32K QUICK BROWN BOX ...$99 64K QUICK BROWN BOX...$129 Bedford MA 01 730 

UTILITIES DISK..$6 Q-DISK CP/M RAMDISK...$10 617-275-0090 617-862-3675 

SPECIAL PACKAGES Add $3.00 shipping and handling 
Mass. orders add 5% state sales tax 


~k OLICK BROWN BOX & THE WRITE STUFF 128...$144 


Micro Aided Designs 
P.O. Box 1982 


Placentia, 


CA 92670 


(714) 996-0723 
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THIS (Technological Highbred Integrated System) is a program designed exclusively for 
the Commodore 128. Listed as one of the best programs of 1987 by ‘‘Commodore 
Magazine,’ THIS contains many advanced features not found in any other program. THIS 
proves to be the most user-friendly graphics program, complete with a step-by-step easy 
to understand manual. Using a 1700 or 1750 RAM and a light pen or mouse, THIS is a 
drawing system capable of producing a simple doodle or a sophisticated blue print. 


With THIS you have a possible resolution of 960 by 536 dots per drawing page and seven 
(7) totally separate pages to draw upon. Giving the user a larger area to draw on not only 
allows for larger sized drawings but also increases the amount of details that can be added. 


When it comes to the final step of printing a complete drawing, THIS offers exact-scaling. 
With exact-scaling the completed drawing can be printed to scale within 1/64 of an inch. 
THIS allows for the possibilities of templates to be created and used in real life applications. 
The printout sizes can vary anywhere between 2 by 2 inches to 480 by 32! inches. 


Up to 7 pages of graphic designs 


EXCLUSIVE FEATURES 


Maximum virtual screen resolution of 960 by 536 pixels per page 
Exactly scales printouts as large as 480 by 321 inches 


Real time object rotation and move 
Real time cut, copy, paste, and zoom 


Elastic modes include lines, boxes, circles, ellipses, arcs, and other geometric shapes 
Easily accessed graphics library including over 100 detailed electronic symbols 


Over 700 type sizes 


10 font styles 


MEASURE THE COMPETI 
4 2 6 t 


2 


3 


Retail Price S63.99 


ON WITH T.H.I.S. 


sieht ERE EEE CURL EL Or Aah bebe eb RIL Ais abi ie MA hice ced aiht 9s SSR oR a ORE as AE ee OEE NRRL R eb UCR ie Nn kh asbiotS 2 swe Nee Lk adr iicktih ew we mane shtatteninntreia te 





| Jaan Cihes 128 


=— 








by BilJuliani 

ugg’ler-128 is written by Miklos Garamszeghy of Herne Data 
putoms LTD, Canada. If you are a reader of the Twin 

ities 128 and Transactor Magazines, you are all familiar 
with Miklos’ qualifications of being the CP/M GURU of 
Commodore’s 128. MIKLOS has picked up supporting this mode 
where Von-Ertwine has left us last May By, 


Juggler runs in CP/M mode, that allows the C-128’s various 
smart’ drives to read, write, and format to many different 

es of CP/M disks from other brands of computers. In 
effect, Juggler converts the C-128 into a universal CP/M 
eompu and lets the user swap disks from one computer to 
another without worry. This is especially helpful for 
those who use different computers at work and can take data 
disks home, or that have hundreds of data disks on an older 
CP/M machine and want to upgrade their system, without 


going through the hassle of data transfer or null modem 
routines. This also applies to program disks. If you have 
a CP/M Plus (or CP 


3.0) prceran from your old CP/M 
computer that includes an installation module for screen 

codes then these will work very well on your trusty C-128! 

The System Guide by Commodore gives a brief description of 
reading several types of MFM disks from other CP/M machines. 
Jugg’ler takes this valuable option from less than ten, to 

over 160 by patching the Disk Parameter Table. 


I like menu driven programs, windows and flashing messages. 
J uge ler uses all of these. Typing errors can be corrected 
before hitting <return> and default values for prompls are 
set to abort the current operation. Serene an 
installing a disk type allows you to work with that foreign 
disk for as long as the system is in CP/M mode. You can 
also save up to three different types of disk formats for 
re-use. These three ’saved’ dis es are stored with the. 
file JUGG.DEF on your copy of Jugg’ler, and several copies 
of J beer can be made, each having different default 

files. Juggler even has a built-in PIP (copy) routine that 

will back itself up to another disk. Once you have decided 
on which three format types you will be using most often, 
and have selected the save option, Jugg’ler can be run by 
several different methods. 


Many options for running Juggler are allowed, with the most 
useful being lenlcnveg reviously saved default disk 

type directly from the CP prompt This option is as eas 

to use as one could imagine. Just hit JUGG F at the CP/M 
prompt and a smaller menu will be displayed for choosing 
your selection. Another handy opan is an auto-copy mode 
of Juggler into the REU (device M) with the command JUGG M 
or, into the QBB (device C) cartridge with JUGG B command. 
This is great for the speed freaks and RAM lovers. Similar 

to Q- Disk’s self patching mode, Juggler will also allow the. 
user to directly patch the CCP.COM for auto-booting. 

patch, sadly, does not allow the use of PROFILE.SUB files, 
and can not be used with the auto-booting feature of 

Q-Disk. I would recommend rope Pa a a bare bones CCP 
and use a PROFILE.SUB for both. In all, there are nine 
different J uggler shortcut options that will quickly access 
Juggler, and get you back to your current task. 


When I first got my 1581 drive, and before my long awaited 
28MAY87 disk arrived I desperately needed CP/M support for 
my new little/big drive. Miklos’ programs that modifie 

the 8DEC Systems Disk and ’81 (MG1581) Format.COM solved 
this problem, but created a new headache, when I later 

switched to the 23MAY87 disk. I suddenly found that they 

were not compan My dBase files were in shambles! 
Jugg’ler’s MG1581 disk option would have saved me hours of 
frustrations and file copying. 


Also included are two unique Librarian and Maxi types for 
both the 1571 and 1581. The Librarian increases the number 
of files that can_be stored on a disk, and is handy for 

those little 2K dBase files, while the MAXI increases the 
total storage disk space. 
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The versatile 1571 can also be modified to read Single 

Density (FM) disks by inst a switch and resistor to 

pin 26 of the WD177X controller chip. This modification 

used with J uggler opens another software door for the C128 

CP/M user. ile formatting Single Density disks are not 
ossible, R/W operations let you use the many Osborne 1, 

TRS-80 Model I, Xerox 820, and Zenith 37 programs. 


Juggler in itself a work of art, and its documentation 1s an 
excellent example for all software people to follow. 

Printed on 8 1/2 by 11 paper with an introduction, table of 
contents, beginner’s area, and explanation of terms that is 

all typeset. The docs even point out subtle quirks in CP/M 
Plus giving the user some well needed insight in CP/M DOS. 
The section titles are large for quickly locating needed 
information, and under Technical Details, Miklos explains in 
simple language how Juggler works. However, the skews are 
missing from the Summary of Disk Types, and Miklos needs to 
eliminate the double notation for special drivers (!!) and 
normally supported formats (*) in the same table. 


The most interesting option is for analyzing an unknown CP/M 
disk. Before Soin aetna all sorts of 3 1/2" disks 


in for analysis, be warned that because of the ’81 (and not 
cause the 


be 

J uae any GCR disk subjected for analysis will 
’81’s LED to stay on, indicating an open command channel. 
The docs mention an error message, but none appear, and you 
might think that the drive is locked up. Any disk access 

L clear the command channel, and any disk swapping while 
in this condition will be harmless. Future updates 
clarify this in the documentation. 


Juggler is a versatile, well written CP/M Program for the 
C-128. If you are a CP/M user, then this is a “must have’ 
for your library. With the loss of the 1571 drive, J uggler 
will surely play an important role with the 1541 and 1581 
CP/M formats. Want IBM compatibility in 128 mode? Use Big 
Blue Reader. For CP/M compatibility, get Jugg’ler. 


MAS-128 


Full-Featured 6502/6510/8502 Symbolic Assembler for the 
C-128 based upon the Innovative C-64 Midnight Assembly Spstem. 


¥ 80 Column RGB Full Screen Editor. 
sy Executes from RAM O or RAM 1. 


x Supports 1700/1750 REU with Built-in Proprietary 
RAMDOS, complete with commands for transferring 
entire disks to and from REU. 


vy Makes absolutely NO calls to ANY of the the C-128 
ROMs (contains its own keyboard, video, and serial 
/O drivers). Indispensable to the programmer who 
wishes to design C-128 ROM replacements. 


vy Multiple Statements per line of Source Code. 
ye Not Copy Protected! Archival Backup Encouraged. 


Direct Inquiries to: 


Mountain Wizardry Software 
P.O. Box 66134 
Portland, OR 97266 


Tech. Support (503) 265-2755 
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by Rick Kane ; 

e all love to show off what can be done with RGB graphics 
on the 128. But when it gets right down to it, it takes a 
lot of time (not to mention talent) to draw all those 
pictures to show off with. And many very nice graphics 
already exist, available on BBS’s, having been either ported 
to a compatible format from Amiga or Macintosh formats, or 
created with one of the several fine paint packages 
available on the 128 and 64. Of course, each has a file 
format tailored to its characteristics. And just because 
you can download a graphic and view it is no guarantee that 
you'll be able to use it in you own programs. 


So no one really needs to be told the value of having the 
tools to convert from one format to another, With this 
rogram, you will be abie to take a Geos Photo Scrap (the _ 
ile you get when you CUT or COPY from the Geopaint EDIT 
requester) and make an 8x8 color Basic 8 BRUSH hile. The 
brush can then be pasted, see and otherwise handied 
just as if it had been drawn with a Basic 8-based paint 
program such as Basic Paint, Spectrum 128, and others. 


This brings up a bone I have to pick. I know Berkeley 
Softworks has just released GEOS 128 v2.0, and it has many 
improved features over its predecessor. But here we are, 
quite easily displaying color graphics in 80 column mode 

with only 16k of video RAM, crying for color support in 
arguably the best graphics program available in the 8 bit 
world. The standard answers are that it would take too much 
memory, it would be too slow, etc. But we’re talking the 

128 here, and while in 80 column mode there are bytes 
of programming space available that are normally occupied by 
the 40 column screen. Slow? Not to anyone who’s been 
suitably impressed with the abilities of Basic Paint. 

Besides, the 80 column screen allows the use of FAST mode. 
Pve captured an 80 column Geopaint screen and squashed it 
to 640x176 (with the same work screen area), just to prove 
how little the appearance would need to change. Ah well, 
I’m sure someone will hear us someday. 


As to the conversion process, Geopaint presents special 
problems, with its compaction schemes to keep disk access 
times down, VLIR format, and USR files. By concentrating on 
Photo Scrap files, we cut down on the complexity in severa 
ways. First, Photo Scraps are sequential in format (though 
labeled USR), so a relatively simple get# loop will read 1t. 
Second, a Geoban file can represent 640 x 800 virtual 
resolution. Holding that document in memory (uncompressed) 
would require 64000 ee for bitmap and 8000 bytes for 
attributes, which would require a fair amount of juggling. 

Then it would need to be broken into smaller pais anyway, 

for 16k systems and for any paint programs where the picture 
remains in memory. (The maximum 8x8 color document with 64k 
RAM would be x 728). 


As luck would have it, the Geos programmers chose to save 
their picture data from left to right across scanlines, just 
like the 8563 chip, rather than in the "8 bytes stacked per 
character" method used by the VIC chip. This was done 

ecause bit-mapped data compresses better horizontally. 
This makes sense, if you think about the case of a pattern 
fill. VIC pete are generally based on 8x8 cards, soa 
pattern fill would place the same byte at the same scanline 
position in each card. This results in a higher probability 
overall that the byte in the position immediate y to the 
right (or left) of one position will be the same, leading to 
better compaction. In any case, that takes some of the work 
out of getting the data onto the 8563 screen. 


Geos uses three modes to maximize compaction. In each mode, 
the first byte is taken as the COUNT followed by the 
appropriate amount of data. In the first mode, when COUNT 
< 128, indicates that the next byte is to be repeated COUNT 
times. The second mode is a string of data -- a’word’-- 

used sequentially. COUNT is between 128 and 220 inclusive, 
and the data string is the next COUNT-128 bytes, used once 
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each. The third mode, BIGCOUNT, allows further compaction 
of patterns. If a string of one repeats several times, 

COU NT will be between 221 and 255. The number of data bytes 
is COUNT-220. The next byte is BIGCOUNT, telling how many 
times to repeat the string of data bytes. 


The decompression routine is not fast, being written in 
Basic, but it uses FAST mode and really isn’t that bad. A 
COUNT byte is gotten from disk, and the appropriate 
decompression routine is called for each mode, until the 
Photo Scrap’s full dimensions have been addressed. When 
Geos creates the scrap, it doesn’t distinguish between 
bitmap and color data; they are compressed the same way. So 
it is possible for a compression at the end of the bitmap to 
include both bitmap and color data. This will happen if, 

for example, the last row of the scrap is 00’s (the scrap 1s 
slightly larger than the object you cut, perhaps, and 
contains blank space) and the first color data 1s the same. 
So each mode routine must check if data to repeat 1s left 
over when the last scanline is done, and finish off at the 
start of attributes. If no data is left, the switch to 
attribute memory is handled at the proper time by the main 
routine at 1000 - 1080. 


Color bytes are in the VIC format, where 0 1s black, 1 
white, 2 red, etc. But the RGB colors don’t match those 
numbers; so a conversion array is set up. Also, the color 
nibbles effect foreground/background in the reverse way; 
this is also handled when the byte is gotten from disk if 

the color change flag is set. If the Photo Scrap is 
monochrome, cut either from the 80 column screen or with 
COLOR OFF on the 40 column screen, there will be just one 
byte of color data for the entire scrap. In this case, the 
get-a-byte routine at 5000 will recognize the end of file 
marker (ST < >() and just leave the current byte to be 
handled until the scrap is filled. 


Once the Photo Scrap is on the screen, it can be @STASHed in 
compressed form to a brush structure in a buffer. I chose 

bank 1 for the buffer because the data is relatively small 

(no more than 80*176 + 80*22, or 15840 bytes maximum 
uncompressed), and it is an easy matter to protect Basic’s | 
variables from corruption. After the brush is @STASHed, it 
can be written to disk with the @SSTRUCT command. To get a 
better understanding of the formats for Geos and Basic 8, I 
suggest "The Official GEOS Programmer’s Reference Guide’ by 
BSW, and the Basic 8 Manual. You don’t need to own Basic 8 
to run the conversion program, but you do need the runtime 
library, which is available through most BBS’s and clubs. 

Then use the program "GEOS/B8 CONVERT" to boot the | 
runtime library and run "GEOSCRAP-2B8". If you own basic 8 
you can simply boot the editor and run the latter. 


When you run the program, you will be told that the menu 1s 
on the 40 column screen. It then asks for the source drive. 

If you answer ’0’, the program will end. After a catalog of 
all USR file on the appropriate disk, enter the filename you 
want to convert. Usually, you can leave it as’Photo | 
Scrap’, because Geos won't let you rename it to anything 
else. You can rename them in Basic to put many scraps on 
one disk, but this is only practical if you have a KAM 
expansion unit to allow for quick reboots each time you exit 
Geos to rename. The program will handle ’not found’ errors, 
but I make no guarantees about what will pappen if you try 
to convert some other USR file, like the Desktop! When the 
file is found, the width and height in pixels is displayed 

then the VIC screen blanks while the brush is drawn. When 
it is done, you’ll be asked for a filename ("brus.’ will be | 
automatically added to the name you awe) and the brus is 
saved. To display a brus quickly, exit the program, then 

type this line: 


@ clear,0,3,15:(@ display,0,device,0,brushname,0,0 


Continued on Page 14 
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Continued from Page 13 
GEOS/B8 CONVERT: 


10 DV=PEEK(186) : FAST: BLOAD"RTLB8" , BO, P4864, UCDV) : SYS4864 
20 BLOAD "P.PTRDEFS",BO,P2816,U(DV) 

30 KEY8,"" 

40 RUN "GEOSCRAP-2B8V1.2" ,UCDV) 


GEOSCRAP-2B8V1.2: 


O REM GEOSCRAP-2B8V1.2 

1 REM BASIC 8 FORMAT CONVERTER - 16K SYSTEMS 

5 REM FROM GEOS PHOTO SCRAP 

10 REM BY RICK KANE <C> 1989 

13 BANK 15 

15 FAST: @WALRUS,O:GRAPHICS:@TEXT:PRINT"SEE 40 COLUMN SCREEN FOR 

MENU": GRAPHICO 

25 POKE47,0:POKE48, DEC("94"):CLR:REM MOVE START OF VARIABLES UP 

30 DIM WRD(35),CL(15):GOSUB5500:REM DEFINE COLORS 

40 WR=DEC("CDCC") : WM=WR-2:REM WRITE 8563 REGISTER, MEMORY 

60 DV=PEEK(186) 

100 BM=0:AT=14500:REM BITMAP, ATTRIBUTE ADDRESSES 

110 aSCRDEF,0,0,3,640,176,BM,AT:REM SET UP 16K 8X8 SCREEN 

120 @BUFFER,1,1024,36863:REM BUFFER IN INT BANK 1 AT $0400 

130 TRAP 9999 

200 SLOW: SCNCLR:PRINT CHR$(14);"GEOS SCRAP TO B8 BRUSH IMPORTER" 

201 INPUT"SOURCE DEVICE NUMBER OR O";DV:IF DV=OTHEN 9999:ELSE 
IFDV<U8 OR DV>23 THEN200 

202 IF DD=0 THEN DD=DV 

203 INPUT" DEST. DEVICE NUMBER"; DD:IF DD<8 OR DD>23 THEN202 

205 PRINT" INSERT GEOS DISK IN DRIVE"DV:PRINT" THEN PRESS A KEY" 

210 GETKEYK$ 

212 CATALOG"*=U", UCDV) 

214 PS$="PHOTO SCRAP": I=LEN(PS$):POKE 2592,1:FOR J=1 TO I:POKE 
841+J,ASCCMIDS(PS$,J,1)):NEXT J:POKE 208,I1: INPUT"NAME OR 
$";PS$: IFLEFT$(PS$,1)="$"THEN 200 

216 IF PS$="PHOTO SCRAP" THEN ROStecems Ben CONVERT TO ASCII 

220 PRINT"SEARCHING FOR PHOTO SCRAP. 

300 CLOSE2:CLOSE15:OPEN15,DV,15: OPEN2, DV, 2,PS$+",U,R": 
INPUT#15,EN,E$,ET,ES 

310 IFEN<>0 THEN CLOSE2: CLOSE15: PRINT: PRINT" ERROR: "E$: SLEEP1: 
GOTO200 

315 PRINT" FOUND!":PRINT"READING..." 

320 GET#2,WD$,HLS,HHS: WD=ASCCWD$) : HT=ASCCHL$)+256%ASC(HH$) : REM 
WIDTH, HEIGHT 

325 PRINT"WIDTH:";WD*8:PRINT"HEIGHT: "; HT: SLEEP1 

330 FAST: aSCREEN,O:@CLEAR,O,3,15:REM WHITE ON LIGHT BLUE 

340 SYSWR,22,6:REM STOP DISPLAY AT 176/8 CHARACTERS 

399 REM START OF DECOMPRESS/CONVERT ROUTINE 

400 UP=BM:GOSUB900: HB=HT: REM UPDATE = BITMAP, HEIGHT.BYTES = 
HEIGHT. PIXELS 

405 CC=0:BOTSCR=0:REM COLOR CHANGE FLAG, BOTTOM OF SCREEN 

410 GOSUB1000:REM CONVERSION ROUTINE 

420 CLOSE2 

540 SLOW: PRINT" PRESS A KEY...":GETKEYKS 

945 NAMES="": INPUT "OUTPUT FILE NAME ('BRUS.'+)">NAMES 

546 IF NAMES=""" THEN BEGIN: INPUT "CONTINUE WITHOUT 
SAVING" 7; Y$: LFLEFT$CY$,1)<>"Y" THEN5S4S5 : ELSE214: BEND 

550 NAMES=LEFTS$("BRUS. '"+NAME$, 16) 

555 AD=@STASH,0,1,0,0,0,WD*8,HT,1:REM STASH BRUSH IN BUFFER 1 

560 IFAD<OTHENPRINT"STASH FAILURE. '":SLEEP4:GOTO590 

570 @SSTRUCT,0O,DD,NAME$:@SEND:REM SAVE IT 

580 INPUT#15,EN,E$,ET,ES: IFEN<>0 THEN 
PRINT: PRINT" ERROR: "E$:GOTO540 

590 GOTO200 

900 REM SET UPDATE ADDRESS 

910 UH=INTCUP/256) : UL=UP-256*UH 

920 SYSWR,UH, 18: SYSWR,UL, 19: RETURN 

999 REM START OF FILE READ/SCREEN WRITE 

1000 XP=0:YP=0 


1010 


1020 : 
1030 : 
1040 : 
1050 : 


1060 


1065 
1070 
1080 
1499 
1500 


1510 
1520 
2000 
2010 
2020 
2030 
2040 
2044 
2046 
2048 


2050 


3000 
3010 
3020 
3030 
3040 
3044 
3046 
3048 
3050 
3060 
4000 
4010 
4020 
4030 
4040 


4050 : 
4060 : 
4070 : 
4074 : 
4076 : 
4078 : 


4080 : 
4090 
4100 
3000 
5005 
5010 


5020 
5499 
5500 
5510 
5999 
6000 
6010 
6020 
6030 
6050 


6070 
9999 


—— The Commodore 128 Joornal Issue #24 Page 14 


GEOS to BASIC 8 


DO 
GET#2, COUNTS : COUNT=ASC (COUNTS) 
IF COUNT<128 THEN GOSUB 2000 
IF COUNT>127 AND COUNT<221 THEN GOSUB 3000 
IF COUNT>220 THEN GOSUB 4000 
IF BOTSCR=1 AND CC=0 THEN GOSUB1500:REM BOTTOM OF SCREEN 
REACHED 1ST TIME 


IF BOTSCR=2 THEN EXIT 

LOOP 

RETURN 

REM SWITCH TO START OF ATTRIBUTES 


UP=AT : GOSUB900 : HB=INTCHT/8): REM HMEIGHT.BYTES = 
HEIGHT. COLOR. CARDS 

CC=1:XP=0:YP=0:REM COLOR CHANGE ON, X, Y POS ZEROED 
RETURN 

REM MODE QO; SINGLE BYTE REPEAT 
GOSUB5000:REM GET A BYTE 

1=0 

DO UNTIL I=COUNT 

SYS WM,BT: l=I1+1:XP=XP+1: IF XP<WD THEN 2050 
UP=UP+80 : GOSUB900: XP=0: YP=YP+1 

IF YP<HB THEN 2050:REM NOT END OF BOTTOM ROW 
BOTSCR=BOTSCR+1:IF I<COUNT THENGOSUB1500:REM IF LOOP 
UNFINISHED, SET TO ATTRIBUTE ADDRESS AND CONTINUE 
LOOP 

RETURN 

REM MODE 1; SINGLE WORD; 'COUNT' BYTES LONG 
COUNT=COUNT-128 

I=0:DO UNTIL I=COUNT 
GOSUB5000 

SYS WM,BT: I=1+1:XP=XP+1:1F XP<WD THEN 3050 
UP=UP+80 : GOSUB900: XP=0: YP=YP+1 

IFYP<HB THEN 3050 

BOTSCR=BOTSCR+1:IF I<COUNT THEN GOSUB1500 

LOOP 

RETURN 

REM MODE 2; WORD REPEAT 'BIGCOUNT' TIMES 
COUNT=COUNT-220 
GET#2, BIGCOUNTS : BIGCOUNT=ASC (BIGCOUNTS) 

FORI=1 TO COUNT: GOSUB5000: WRDC1I)=BT: NEXT: REM GET WORD 
J=0:DO UNTIL J=BIGCOUNT 

1=0:DO UNTIL I=COUNT 

SYS WM,WRDCI+1) : I=1+1: XP=XP+1 

IF XP<WD THEN 4080 
UP=UP+80 : GOSUB900: XP=0: YP=YP+1 

IFYP<HB THEN 4080 
BOTSCR=BOTSCR+11: IF I<COUNT THEN GOSUB1500 
LOOP 

J=J+1: LOOP 

RETURN 

IF ST THEN RETURN:REM END OF FILE; BT UNCHANGED 
GET#2,BT$:BT=ASC(BT$) 

IF CC=1 THEN BT=16*CL(BT AND 15)+CLCINT(BT/16)):REM 
REVERSE COLOR NIBBLES & CONVERT 
RETURN 

REM DEFINE RGB EQUIVALENTS FOR VIC COLORS 
RESTORES510: FORCL=0TO15 : READCL(CL) : NEXT: RETURN 
DATA 0,15,8,7,10,4,2,13,11,12,9,1,6,5,3, “ 

REM CONVERT PS$ TO ASCII 

PP$="": FORI=1TOLEN(PS$) 

P=ASC(MID$(PS$,1,1)) 

IF P>192 THEN P=P-128:GOTO6050 

IF P>64 AND P<96 THEN P=P+32:GO0TO6050 
PP$=PP$+CHRS(P) 
NEXT 

PS$=PP$: RETURN 

DCLEAR ON UCDV):GRAPHIC 5:aTEXT: FAST 
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by Miklos Garamszeghy 

"BOMBS-AWAY'" is a two player game for the C-128 requiring 
two joysticks and two video monitors (or one monitor and a 
television set). Each player controls their portion of the 

game from a separate screen. 


The C-128 has many interesting, often unique, features for a 
home computer. One such feature is its dual video 

sl poet The C-128 has two os totally independent 
video output chips: the 8564 VI used in 40 column mode 
and for the TV RF output) and the VDC (used in 80 
column mode). 


The ability to use two or more separate video screens is 

often found in high priced business micro-and mini 

computers. It is particularly useful in gr x cy 

applications (such as computer aided os king, or CAD) where 
menus and command prompts are often displayed on one screen, 
while the graphic image is displayed on a second. Besides 
providing a larger on screen graphics display area, use of a 
second screen leaves the penery graphics displa 
uncluttered by menus and command prompts. This is very 
handy for m hi-res graphic screen dumps of just the 
image portion, or for taking photographs of a screen image. 


Many commercial software packages for the C-128 will work 
with either 40 or 80 column mode individ but very few, 
if any, will take full advantage of using both & 

screens simultaneously to display different information. 
(Strictly speaking, only one video processor is actually 
used as the output device at any given time. The illusion 
of using two screens "simultaneously’ is created by 
ewitening back and forth between the video processors, as 
required for updating each screen.) Because each video 
display processor has its own screen RAM on the C-128, 
switching screens will not erase either display. 


SWITCHING SCREENS WITH BASIC: 

C-128 BASIC 7.0 contains several methods for switching video 
saa ape ks Perhaps the simplest and most direct method is 

wl e GRAPHIC command: 


GRAPHIC 0 GIVES YOU 40 COLUMN TEXT MODE 
WHILE GRAPHIC 5 GIVES YOU 80 COLUMN TEXT MODE 


This works in either immediate or program mode. In program 
mode, you can also toggle (that is Awite ) displays, either 
40 to 80, or 80 to 40, with a simple: 


PRINT CHR$(27)"X" 


This is equivalent to the command Escape (or < ESC >) X in 
immediate mode. A third method for use in immediate mode 
only, is to select the appropeate sition of the "40/80" 

key and then press the < RUN/STOP> - <RESTORE> key 
scaler or a soft system reset, or the reset button for 

a cold start. 


Since each screen is totally independent, any character 
attributes, WINDOWing, or cursor ioning that you want 
aa on both screens (such as colors, reverse text, 

etc) must be repeated for each screen. For example, 

printing the control code for white characters (CHRS(5)) 
when the 40 column screen is on will not affect the color of 
the 80 column screen characters. 


Most BASIC 7.0 screen output commands such as WINDOW, PRINT 


and CHAR work on the currently selected display screen only. 
With BASIC 7.0, the graphics pa fare sso a such as 4 
LOCATE, CIRCLE, W, etc., however, only work with 40 


column graphics mode, regardless of what the currently 
selected aeey mode is. In order to be able to view the 
product of the graphics comm however, you must select 
one of the appropriate medium or high resolution graphics 
modes for the 40 column screen. { o use 80 column 
graphics, you pany need ane ced version of BASIC, 
such as BASI 8.0.) 


DUAL VIDEO FUN 


You can also "print" to the 40 column screen while in 80 
column mode. This is done by POKEing the appropriate 
character codes to the proper locations of the 40 column 

chip video RAM (hex to $07ff; dec 1024 to 2047). A 
similar, although somewhat more complicated, procedure can 
be used for sending character information directly to the 80 
column video RAM while in 40 column mode. (The 80 column 
chip has 16 K ora C-128) or 64 K (C-128-D or enhanced 
C-128) bytes of dedicated display memory which can only be 
accessed indirectly through the control registers of the 

8563. The memory locations cannot be POKEd directly by 
either BASIC or machine language.) 


SWITCHING SCREENS WITH MACHINE LANGUAGE: 
There are also several ways to switch displays using machine 
janguage.. The KERNAL has a routine accessed through hex 
$ff5f (decimal 65375) which is equivalent to BASIC’s PRINT 
CHR$(27)"X" or <ESC>X statement. This can be called from 
within your ml code with a simple: 

JSR SFFSF 
or from BASIC with: 

SYS 65375 
This routine, which eventually ends up executing code at hex 
$cd2e, swaps the contents of the "active" screen pointers at 
hex $e0 (dec 224) to $f9 (dec 249) (those for the current 
screen being printed to) with those of the "passive" screen 
starting at hex $0a40 (dec 2624) hess for the screen being 
switched to). These pointers include things like current 
window positions, current cursor column and line, etc. They 
are needed for switching back again in a controlled manner. 
The passive data storage are is just a buffer used for | 
temporary storage of the pointers for the screen which is 
not currently being used. 


The KERNAL routine also sets the value of memory location 
hex $d7. You can check which screen is active by PEEKing 
location hex $d7 (dec 215). If this location has a value of 

hex $80 os 128), the 80 column screen is active. If the 

value is 0, the 40 column screen is active. If you do not 

care about preserving current screen windows, cursor 
location, etc., you can switch screens directly in either | 
BASIC or machine language by changing the value of this 
byte. You can also determine the current display mode from 
the RGR(x) function. RGR(x) ve to 0 indicates that the 
40 column text screen is active, while an RGR(x) value of 5 
means that the 80 column display 1s on. 


A SIMPLE DEMONSRATION: 
"BOMBS-AWAY’ is a simple, yet fun, demonstration of using 
two screen video on the C-128. It is a two player game 
written in BASIC 7.0 that requires two joysticks and two 
video monitors (or one monitor and a television set). Each 
player controls their portion of the ae from a separate 
screen. (The display screens should be positioned back to 
back so that epponcuts cannot see each other’s screen.) 
Player 1 uses the 80 column screen and joystick port 1, 
while player 2 uses the 40 column screen (or TV set) and 
joystick port 2. 


The object of the game is similar to the classic "Battle 
Ship" strategy game: each player "hides" a number of 
targets (10 in this case) on a 10 by 10 grid. The players | 
then take turns dropping "bombs" on their opponents: 
You score by ae one of your opponent’s targets. The 
first player to hit all ten of the opponent’s targets 1s the 
winner. 


Type in and SAVE a copy of the program in LISTING 1. It is 
quite short, but pay careful attention to the opeceen 
special cursor control characters contained in the PRINT and 


HAR statements. 
Continued on Page 16 
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Continued from Page 15 

After a brief opening introduction screen, the game set up 
screen will appear on both ree s. The top left quadrant 
of the screen contains a grid o id by 10 elemenis. This is 
where you will initially hide your own targets during the 
set up phase of the game; and then move about to hit your 
enemy s targets during the play portion of the game. It 
will ey e filled with graphic "X"’s (shift-v’s). At 

the top right of the screen there will be a row of 10 

circles (shift-w’s). These represent the number of your 
targets which you have not yet hidden. 


HIDING YOUR TARGETS: ; 

Player 1 will be asked to hide the targets first. This is 
done by moving the joystick controlled flashing cursor 
around the grid to the location where you wish to hide a 
target, and then pressing the fire button to insert the 
target. The number of remaining targets displayed at the 
top right of the screen will be decreased by one for each 
target hidden. The "X" in the grid will be replaced by a 
circle if a target 1s hidden there. 


If you change your mind (before placing the last target) and 
want to change the location of a hidden target, press the 
fire button when the cursor is in the cell containing the 
target that you wish to move. The cell will change back to 
an "X" and the number of remaining targets displayed at the 
top right will be increased by one. 


When player 1 has hidden all of his targets, the procedure 
will be repeated on the 40 column screen for player 2. When 
player 2 has finished hiding targets, the main game screen 
will set up and the game will begin with player 1. 


PLAYING THE GAME: 

The object of the game is to locate and bomb all of your 
i fa targets before he/she gets yours. Each player 
will be given a chance, in turn to drop a bomb on the other 
player’s grid. If you score a hit, you get another turn, 
repeating until you miss. If you miss, the other player has 
a chance to bomb you. 


The 10 by 10 main playing grid at the top left of the screen 
is initially filled with "X's. Under these "X"’s are your 
opponent’s hidden targets. You cannot see your opponent’s 
targets and must guess at their locations. As you score 

hits, the X’s will be replaced by O’s. Locations that you 
have bombed, but missed a hidden target, will be shown as 
blank spaces. 


At the top right of the screen is a mini 10 by 10 status 

grid. This second grid contains the locations of YOUR 
targets and also your opponent’s shots, so that you can keep 
track of how close your opponent is getting to your targets 
and how many you have left. 


Move the cursor over the main grid to where you think your 
opponent has hidden a target and press the fire button. At 
this point several things happen. The correspondin 
location on your oP onent’s status grid (the top right one 
on his display) will be blanked out. If you scored a hit, 

the “X" in your main playing grid will be replaced by a "O" 
and you will get another turn. If you missed, the location 
on your main playing grid will be blanked out and play will 
switch to your opponent. In either case, the score asp ay 
at the bottom right of the screen indicating number of hits 
and number of shots will be updated. Play ends when one 
player has hit all ten of his opponents targets. Simple, 
yet suitable, sound effects have been added at appropriate 
points to spice up the game. 


Although the rules may sound ved vane pa ae paper, they are 
really gue simple once you nave played a few rounds of 
"BOMBS-AWAY"!! 


For those who are interested, the program works like this. 
Lines 10 to 100 set up the default values for the colors and 
various string variables used to draw the screens. Note 
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that both the 40 and 80 column screens are created in text 
mode using the block character set. That is, 40 column 
hi-res bit map graphics mode is not used. 


Array P(2,10,10) contains the data on where each player has 
hidden targets. Array dee 10) contains the data on where 
each player has dropped bombs. (Although it is recognized 
that these two functions could be readily handled inthe 
same array, se atau them has the advantage of simplifying 
the various video display routines for the game screens. 
Besides, the C-128 has oodles of extra memory anyway.) 


The variable E$ defines the < ESC > X key sequence for 
swapping display screens. 


Lines 110 to 140 print the opening display on each screen. 
The illusion of simultaneous movement on both screens is 
created by switching between the displays and advancing one 
character position each time. 


Lines 150 to 230 are used to set up the “hide target" screen 
on each display. This time, for variation, the G HIC 
command is used to switch back and forth. The CHAR 
statement is used extensively for creating the screen 
images. This BASIC 7.0 feature allows you to print a 
character or character string at a given location on the 40 
or 80 column screen. (In 40 columns, it works with both the 
text display mode and the various bit map graphics modes.) 


Lines 240 to 380 contain the routines for moving the | 
“cursor” and placing the targets. The flashing "cursor" is 
created by the combination of the CHAR command in line 250 
writing a character in reverse video followed by the CHAR in 
line 290 writing the same character to the same location in 
normal video mode. A suitable delay for the pane 1S 
created by the statements in between the two CHAR’s 


The joystick is read and interpreted in lines 260 to 280 

using the JOY(N) function. Positional information in terms 
of screen row (R) and column (C) is calculated in line 250 
from the logical position variables X and Y (also used as 
indices for arrays P() and later H()), according to the 
current screen size (40 or 80 columns). 


Lines 330 to 340 contain routines for keeping the cursor 
within the bounds of the 10 by 10 grid. 


Lines 390 and 400 set up the 40 and 80 column displays for 
the main game. 


Lines 410 to 550 are the main game routines for moving the 
cursor, firing a bomb, and detecting a hit or a miss. Line 
490 updates the status grid on your opponent's display. 
Joystick control and other elements are similar to those 
used in the target hiding routines. 


Lines 560 to 620 contain the sound effects and end-of-game 
routines. The sound effects use BASIC 7.0’s advanced SOUND 
and PLAY commands for easy programming of the SID chip. 


Although BOMBS-AWAY is a rather trivial use of dual screen 
video, it does serve to demonstrate many of the advanced 
features of the C-128 and BASIC 7.0. 


See Bombs-Away listing on Page 17 
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{0 COLOR 0,7:COLOR 4,7:COLOR 5,2:COLOR 1, 2:GRAPHICS, ! 
2) FAST: DIM P(2,10, 10) ,H(2, 10, 10) sES=CHRS (27) +8" 

MO $2" pt tt tt tr tt ot "NS" WHT BOMBS AWAY-128 ESSE." 
OR="1 1 1 ot Lod dL TE US SNS2"M, GARAMSZEGHY":SY$=" SET YOUR TARGETS" 


50 M$=" b—-4+--—--+-— +--+ — + 4 HH Ht SS SS rca “s ¥$="82 YOUR TURN 48" 
60 B$=" b-—4——-b-4t de ge " FS=" FIRE BUEN REANY® 
70 T8$=" re rn ee ee ee renee a oe aes seen wesc once Se ay 8 





ees a eee ee ee 
110 PRINT® [CLR DOMN 1 DOWN DOWN1C DOM TCDORICDOWN DORN? DOWN DOWN ~~ "s :GRAPHICDs PRINT" CCLRC DOWN] DOWN] DOWN? {DOWN (DOWN [DORN] [DORN 


120 FORI=17021:PRINTES® "WS" [LEFTI(LEFTI(LEFTI(LEFTI(LEFTI(LEFTI(LEFTICLEFTICLEFT CLEFT CLEFT CLEFTI(LEFTI (LEFT CLEFT CLEFT CLEFT {LEFT ICLEFTICLEFT)"s :NEXT 
130 CHAR, 40,13. "BY" :GRAPHICO:CHAR, 18, 13, "BY":CHAR, 12, 15, (MGS) 

140 GRAPHICS: CHAR, 34, 15, (MGS) :FORE=1103:60SUR420: O0SUBA I 0: NEXT 

150 GRAPHICS, 1: GRAPHICO, 1: PRINT® (DOWN 1"T$: GRAPHICS: PRINT® [DOWN] *T8S 

160 FORI=1T00:PRINTRBS: PRINTNBS: GRAPHICO: PRINTR$: PRINTMS: GROPHICS: NEXT 
170 PRINTRE$: PRINTBSS: : GRAPHICO: PRINTRS: PRINTBS : GRAPHICS 

180 CHAR, 10, 0,6S:CHAR, 65,71, "PLAYER 1%, 1:CHAR, 65,1, S$: CHAR, 66,3, "TARGETS" 
190 CHAR, 60,15, °HITS | >>*: CHAR, dO, 17, “SHOTS >}*:ERAPHICD 

200 CHAR, 1,0, 86: CHAR, 30, 21 "PLAYER 2", 1: CHAR, 28, 1,58: CHAR, 27,3, "TARGETS" 
710 CHR, 25,15, "HITS >S*:GHAR, 25,17, "SHOTS 5)": GRAPHICS 

73) FORI=11010:FORJ=1 1010: CHAR, 481-2, 280, =" 

230 GRAPHICO:CHAR, 281-1, 283, "="" :GRAPHICSSAEXTS, | 

24) CHAR, 10,24, YS+SYS:ME1: Tet: Yat NG=: Aad: Be? 6=75 

250 YO=1: YOY: R=28V: CA T-Bs CHAR, CR, “CRVON] *#CHRS (P(N, X,Y) #118) +" [ROE] " 
260 J=JOY(N) : IFSAND! 2BTHENP(W, 1, ¥)=- (P(N, X, ¥)=0) GOTOS10 

770 IFJ=3THENY=1+{ : GOSUB330: EL SE IF 2 7TMENN=1-1 : B0SUB330 

280 IF J=STHENY=V+1 : GOSUR340: EL SE IFJ=1 THENY=7-1 :G0SUBTA0 

290 CHAR, XOtA-B, YO#2, CHRS (P(N, 10, 10) +118) 

300 [FNS 10THEN250: EL SE360 

310 IFP(N, X,Y) THENNG=NS#1:CHAR, S-NG, 1," "ELSENSENS-1:CHAR, S-NS-1, 1, tc" 
2 607020 


3 
330 TFX=OTHENY=10: ELSEIFX=11 THENX=1 
34) IFY=OTHENY=10: ELSEIFY=1 1 THENY=1 
350 RETURN 


340 IFN=2THENGBO: ELSECHAR, 10, 24, BL$#BL$: GRAPHICO: S=38 
370 CHAR, 1, 24, YS+SV$:Ne2: Lat: Y=1 NG=O:A=2: Bot 6070290 
380 CHAR, 1, 24, BL S#BL$: GRAPHICS 

390 FORI=11010sFORJ=1 1010: CHAR, 481-2, 280, %»:":CHAR, 6441, J, CHRS(P(1, I,)+118) 

400 GRAPHICD: CHAR, 281-1, 28J, "><" sCHAR, 2741, J, CHRS(P (2, 1, J} +118) GRAPHICS: NEXT, | 
410 XP=LsYieds X2=:Y2=1 NS (1) =0sNS (2) 20: NH (Lb=0: MH (2) 20 

420 CHAR, 10,24, Y$4F$:N=2:A=4: B=2s e275 X=K1: Y=V1 

430 XO=K: YO2V:R=2tY:C>ASY-B: CHAR, C,R, "CRVON)"+CHRS (H(3-N, X, Y)-41 18) +°CRVOE]" 

440 J=JDY (3-N) 3 IF 2=1 22 THENAQO 

450 [F J=3THENY=1+1 : GOGUBS30: ELSEIF J=7THENY=1-1:GOSUBI30 

460. [FJ=STHENY=V+1 s GOSUBS40: ELSEIF J=1 THENY=V-1: G0SUB340 

470 CHAR, XO8A-B, YOR, CHRS (H(3-H, X0, YO) +118) 6070430 

490. GOISUBG20: NS (3-N) =NG (3-N)+1 : RB=STRS (NG (3-N) ) CHAR, 342N, 17, NSS 

490 PRINTES: CHAR, S#X, Y, " "SPRINTES) TFP(N 1, = THEN (NK ¥)=02 6070540 

500 IFH(S-N, X, V) C31 THEN (SN, XV 24 

510. [FNe1 THENR2=%: Y2=V: CHAR, 1,28, BLS+BL$: GRAPHICS: GOTD420 

520 CHAR, 10, 24, BLS+BL $:GRAPHICO: CHAR, 1,24, YS4F$: H1=L:Y1=V 

530 NelsAe2:B=1:S=64s X=X2s ¥=¥2: 60704 30 

S40 H(3-N, X, VI=1: NH(S-N) =HH (3-0) +1 : GOSUBG10 

550 NHS=STRS (NH(3-N) ) :CHAR, 349N, 15. NHS: [FRH(3-N) <LOTHEN40 

560 SLEEP: PLAY"V104 IF GAUSC. GCIDCD4A. OF IGAAGE® 

570 PRINT{CLR] {DORN { DORN] (DOWN 3 (DOWN [ DOWN) tht YOU WIN 882": POKE209, 0 
5&0 PLAY". HGIFGAOSC. OCI DCUAA. GF [GQAAGGME ": POKE209, 0 

$70 INPUT “COOH DODO AY ANOTHER GAME <V/NS": A: IF AS="Y" THENRUN 


410 VOL15:SOUND2, 8192, 45, 1, 1, 150, 3, 0: RETURN: REM EXPLOSION 
620 VOLI5: SOUND2, 33333, 160, 1, 1000, 400, 1:RETURN:REM BOMB DROP 
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by Fred Bowen 

yone familiar with disk files knows about sequential (SEQ) 
or program (PRG) file types, how they are opened and how 
their data accessed. Folks are also familiar with the 
obvious advantages and disadvantages of these modes: 


they: 
- Frovide easy access to individual bytes, but... 
- Cannot access data already read or written (cannot 
"rewind" the file). 
- Must be re-opened to change access mode (read file vs. 
write file). 


RELative file mode 1s designed to get around these 
limitations and to do so with relative (pun intended) speed. 
It does so by imposing a data structure which must be 
established when the file 1s created; the user must define a 
record with a specific length (less than 255 characters) and 


pean data fields (reserving specific characters for 
1eld delimiters). 


Wouldn’t it be nice to have the capability to move the file 
ointer about a SEQuential or PRoGram file, forwards or 
ackwards? And wouldn’t it be nice to either read *or* 

write data on the fly? And wouldn’t it be nice to use any 

character in any way you wanted? You need look no farther 
than the Commodore RAMdisk utility, version 4.0 or higher. 

There exists an undocumented file access mode in the 

RAMadisk which provides this capability. 


It’s called F’ access mode, or Free’ access. Simply open 
a new or old SEQuential (type =§S) or PRoGram (type = P) 
RAMadisk file for Free access like this: 


OPEN CHANNEL, UNIT, SA, "FILENAME, TYPE,F" 


The file will be created if it does not already exist, so be 
sure to use the correct filename. You set the file pointer 
to anywhere in the file (even beyond the end of the file) 
much as you would access RELative file data, using the 
’P’osition DOS command: 


OPEN CHANNEL, UNIT ,15 
PRINTH15,""P"': CHR$(SA) ; CHR$ (PAGE-LOW) ; CHR$ (PAGE-HIGH) ; CHR$(BYTE) 


Instead of record numbers, you need to know the address of 
the byte in the file. The first byte is page 0 byte 0, and 

this is where the file pointer is placed by default when the 
file is opened. The format of the data is totally free- 
your program can impose any sue desired. As data is 
either read (via GET# or INPUT#) or written (via PRINT#) the 
file pointer is automatically advanced to the next byte in 

the file to be read or written, just like the cursor on the 
display screen is advanced to the next character position 
when you type. The (byte) A tc ies is optional, and if 
omitted defaults to byte 0. If the file pointer is moved 

past the end of the file, the file is automatically expanded 
and the new area filled with $FF (CHR$(255)). As with 
RELative files, when you create a new file using Free mode 
you should position the file pointer to the last byte you 
a to use and write something there (such as the 
CHR$(255) pad byte). 


I do not recommend C128 programmers use the BASIC 7.0 
RECORD# command in place of the DOS ’P’ command shown 
in the above example. The RECORD# command was added 
specifically for RELative files, and the BASIC parser limits 

e (byte) parameter to the ranee ae The values 0 and 
255 result in"? ILLEGAL QU ITY ERROR’, which is 
unfortunate. 


So what is "Free" access good for? Clearly it is not 

without Seas a program must keep track of its 
location within a file, and it 1s not supported by disk 

drives. "Free" access would appear to have some application 
for word processors, editors, and databases, and it would 





Issue #24 Page 18 








REU FREE ACCESS 


seem to provide an ideal method for "patching" program 
files. "Free" access does not require side sectors like | 
RELative files do, so it provides some space savings 1n 
that regard. Why was "Free" access built in? Because the 
mechanisms to implement it were already there, it was easy 
to add this capability. Also, a pauerae producer of 
third-party software had asked for it, but the request was 
never followed up. Why was "Free" access never documented? 
Because, while it is a neat idea, ithad noimmediate 
application and was destined to live alone, trapped within 
ihe REU RAMadisk driver. 


Use it advisedly- "Free" access was never heavily tested, 
and it was not reviewed by the QA (quality assurance) 
people. Like RELative file operations on the RAMdisk, Free 
mode is not very fast. I am working on a neat hack that 

romises to help out in that respect- a way to make the 

disk controller stay resident, ee the time 

consuming swapping that occurs every time the controller is 
needed (for every sequential byte read, nearly 16k bytes of 
data are moved!). Cognito ergo equus sum. 


Herne Data Systems Ltd. 


Featuring C-128 CP/M software by: 
Miklos Garamszeghy 


Jugg ‘ler-128 Now shipping version 3.4. 


Let your C-128 CP/M system read, write and 
format over 140 types of CP/M disks with this 
easy to use utility. Only $19.95" 


QDisk Now shipping version 2.1. 


Now you can use your Quick Brown Box as a 
non-volatile RAM disk in CP/M mode with this 
memory resident driver. Only $11.95" 


Scramb'ler-128 Now shipping version 2.0 


High security data encryption system for 

C-128 CP/M. Protect all of your vital and 
confidential data from un-authorized snooping. 
Only $19.95* 







Herne Data Systems Ltd. 
P.O. Box 714, Station ‘C' 
Toronto, Ont. M6J 331 
(416) 535-9335 


*US §, including postage & handling 
Software worth hunting for! 
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by Mike Gilsdorf. 

ave you ever wished you didn’t have to load those DOS 
utility programs into your por pULet everytime you wanted to 
change a file type, lock/unlock files, append BASIC 
programs, etc.? Wish you could add new commands to your 

k drive and execute them in the same way you rename an 

scratch files? How would ae like to unscratch a file with 
PRINT#15, "UNSCRATCH:Filename"? Well, if you thought that 
these things were only possible if you replaced the ROM, 
used a cartridge or utility program, then surprise! 


As most of you are probably aware, Commodore disk drives 
like the 1541, 1571, and 1581 are smart devices. Each have 
their own RAM, ROM, CPU, and I/O chips. They can be 
Propran mcd to perform tasks in the same manner your computer 

oes. More importantly, these tasks can be done without 
loading or disturbing a current program in your computer’s 
memory. Its sad to see so many utility programs written for 
the computer when in fact many are better suited for the 
drive. Generally speaking, drive pice ams are faster, 
shorter, and more efficient, and they don’t need to be 
loaded over the slow serial bus. 


WHAT IS A DRIVE PROGRAM? 
Drive programs are loaded and run in your disk drive in much 
the same way utility programs are in your computer. After 
receiving the apprcD ate computer command, the drive loads 
the ML program off disk and stores it in its memory (RAM). 
Depending upon the command sent, the drive either 
immediately executes the program, or waits until it receives 
another command such as M-E or Un (where n is a number from 
3 to 9). Programs which auto-execute in the drive on 
command are referred to as "Utility Loaders”. Those which 
auto-execute when the drive is reset or initialized (as in 
the case of the 1581) are called "Auto Boot Loaders". Both 

es of loaders are made up of one or more packets (groups 
of bytes) which hold the ML program. Each packet is 
constructed as follows: 


BYTE 0 LOW BYTE LOAD ADDRESS 

BYTE 1 HIGH BYTE LOAD ADDRESS 

BYTE 2 NUMBER OF PROGRAM/DATA BYTES 
BYTES 3 TO X PROGRM DATA BYTES 

BYTE X+1 CHECKSUM 


Notice that since ae #2 can not be larger than 255, the 
maximum ae of a packet is 259 bytes ? address bytes, 1 
Sie counter, 255 program/data bytes, an 

otice too, that this limits X to a maximum value of 257. 
You can combine or APPEND packets to construct longer files. 
Bytes 0 and 1 in the first peat also serve as the address 
to begin executing once the entire program file is loaded. | 
Depending upon its load address the next packet is stored in 
the drive’s memory usually (not always) immediately 
following the last byte of the previous packet. The 
checksum byte is calculated by adding bytes 0 to X and 
adding a 1 for every carry (over 255) that results. 


Utility loaders must be named as USR type files. You can 
e program file any legal name you wish, except if 
your using a 1541. Due to a bug in the 41 drives, filenames 
or utility loaders had to begin with the "&" 
character. Whether this is still true for the newer 1541 
IIs, ’'m not sure. Personally, I like to name all my utility 
loaders beginning with the "&" character anyway since it 
makes it easier to distinguish them from my other files on 
disk, Also, if the program is written to run only on a 
panna drive (which is true for most u 2 
oaders) I’d recommend you include the name of the drive in 
the filename (e.g., &filename.41 for the 1541). Drive 
programs are executed by sending the following command: 


1 checksum byte). 


OPEN15,8,15,"&0: FILENAME": CLOSE 15 
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If you’re using the DOS wedge, the command 1s sent as 
follows: 


@&0: FILENAME 

If you’re using a 1541 the commands are: 
OPEN1,8,15,"&F ILENAME" : CLOSE’ 

or: 
@&F ILENAME 


Note: Many application programs (such as word processors) 

ill allow you to send commands directly to your drive | 
without having to exit the program. This 1s one of the nice 
advantages of utility loaders and Un commands! 


WHERE TO LOAD: 

Although there are products available which allow you to add 
extra RAM to your drive (e.g., RAMBOard), most of us are 
limited to the amount of memory initially installed. 


1541/71 2K $0000-$07FF 
1581 8K $0000-S$1FFF 


Unfortunately, not all of this is available to us for 

programs. Some is reserved for DOS variables, BAM, work 
area, etc. Programs written for the drive generally load 

into one (or more) of the drive’s 256-byte data buffers. 


BUFFERS 1541/71 1581 
BUFO $0300-$O3FF X X 

BUF1 $0400-$04FF X X 

BUF2 $0500-S$O5FF X X (UN COMMANDS JUMP 

HERE) 

BUF3 $0600-$06FF x x 

BUF4 $0700-$O7FF BAM X 

BUF5 $0800-$O8FF N/A X 

BUF6 $0900-SO9FF N/A X 

BUF? $OAO00-SOAFF N/A BAM 

BUF8 $0B00-SOBFF N/A BAM 

BUF9 $0CO0-$1FFF N/A TRK 


Do NOT load/execute drive programs into the BAM or TRK 
buffers or when there are open active disk files. If you 

do, you run the risk of corrupting your disk making it 
unrecoverable. I usually perfer having my utility loaders 
load into BUF? since it offers the option to execute them 
again on the same or different disk using the Un commands. 


To show you how all this works, let’s write a simple ML 

rogram for the drive which will turn the drive’s activi 
fight (LED) on, then off. We’ll design the program to load 
and execute in BUF2, and we’ll also make use of the U3 and 
U4 commands. Note that these commands are sent over the 
drive’s command (error) channel #15, and work similiar to 
sending an M-E command to addresses $0500 and $0503. (See 
your drive’s user manual for other Un commands and their 
jump addresses.) The DOS routines that turn the LED on and 
off are called SETLDS and ERROFF. For the 1541/71 they are 
located at $C100 and $C123. oe a Well... there 
is a slight quirk. If we RTS immediately after turning the 
LED on, the drive will idaho ge turn it back off again 
once it returns to its normal housekeeping chores. If we 
didn’t have a way to keep the LED on, we might only see a 
very fast flash - perhaps too fast to be seen. One way to 
overcome this is not to exit our drive program after LED 
turn-on, but continue looping until a new command has been 
detected. Location $7C (A ND) on the 1541/71 is used as a 


Continued on Page 20 
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flag to signal the a aesg of a new command. It holds $01 
if a new command has been received, otherwise it holds $00. 
This location is checked/updated with every interrupt. 


Here’s how our program appear once it is loaded into | 
the 1541/71 drive. 


$0500 JMP $0507 ; U3 ENTRY POINT 

$0503 JSR $C123  ; ERROFF -— TURN OFF LED CALSO U4 
; ENTRY POINT) 

$0506 RTS 


$0507 JSR $C100 SETLDS - TURN ON LED 


f 
$O050A LDA #$00 =; CLEAR THE 
$050C STA $7C 3 ATTENTION PENDING CATNPND) FLAG 
$O50E CMP $7C > CHECK THE ATNPND FLAG FOR THE 
; COMMAND 
$0510 BEQ $050E ; JUMP IF NO NEW COMMNAD - KEEP 
; LOOPING 


$0512 RTS COMMAND IS WAITING - EXIT 


For the 1581 drive the program looks similiar. 


$0500 JMP $0507 ; U3 ENTRY POINT 

$0503 JSR $81E5 ; ERROFF - TURN OFF LED (ALSO U4 
+ ENTRY POINT) 

$0506 RTS 

$0507 JSR $81F6 ; SETLDS - TURN OFF LED 

$O5OA LDA $76 GET PRESENT VALUE OF FLAG 

$050C CMP $76 =; SEE IF FLAG CHANGED 

$0510 BEQ $050C ; NO CHANGE SO KEEP CHECKING 

$0512 RTS COMMAND IS WAITING - EXIT 


‘we NS “ wa 


Now enter the BASIC program below. This program creates a 
utility loader on disk (device #8) by assembling our ML 
program into a single packet. Be sure to insert a disk in 

the drive before RUNning it. As a precaution use a newly 
formatted disk. 


10 REM LED - BY MIKE GILSDORF (C) 1988 

20 DV=8: OPEN 2,DV,2,"0:&LED,U,W": REM DV IS THE DEVICE NUMBER 
30 READ A: IF A<>256 THEN PRINT#2,CHRS(A);: GOTO 30 

40 CLOSE 2 

50 REM UTILITY LOADER FOR BUF2 


100 DATA 0 >REM BUF2 LO BYTE ADDRESS 
110 DATA 5 >REM BUF2 HI BYTE ADDRESS 
120 DATA 19 >REM NUMBER OF PROGRAM/DATA BYTES 


130 DATA 76,7,5 >REM JMP $0507 
140 DATA 32,35,193 :REM JSR $C123 


150 DATA 96 >REM RTS 
160 DATA 32,0,193 :REM JSR $C100 
170 DATA 169,0 *REM LDA #$00 


180 DATA 133,124  :REM STA $7C 
190 DATA 197,124  :REM CMP $7C 
200 DATA 240,252 :REM BEQ $050E 


210 DATA 96 >REM RTS 
220 DATA 243 >REM CHECKSUM BYTE 
230 DATA 256 >REM END-OF-DATA MARKER 


NOTE: If your using a 1581 verify the device number in line 
20 is correct, and replace the following program lines: 


120 DATA 17 >REM NUMBER OF PROGRAM/DATA BYTES 
140 DATA 32,229,129 :REM JSR $81E5 

160 DATA 32,246,129 :REM JSR $81F6 

170 DATA 165,118 :REM LDA $76 

180 REM DELETE 

190 DATA 197,118 >REM CMP $76 

200 DATA 240,252 :REM BEQ $050C 

220 DATA 149 >REM CHECKSUM BYTE 


After RUNning the BASIC program, if everything went 
correctly, you should now have a utility loader stored on 
disk. Here’s how it should appear in the directory: 


1 "&LED" USR 
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We’re ready now to have the drive load and execute the 
utilty loader. In direct mode type: 


OPEN15, DV,15,"&0:&LED" 
For the 1541 use: 
OPEN15,DV,15, "SLED" 


You should see the activity light on. To turn it back off, 
type: 


PRINT#H15, "U4" 


To turn it back on again without reloading, remove the disk 
and type: 


PRINT#15,"U3" 
Type: 
PRINT#15, "U4" 


to turn it back off. Or as an alternative, to see the drive 
turn the LED off as part of its housekeeping duties, type: 


CLOSE15 


If these commands didn’t work properly, recheck your typing, 
and be sure the DATA statements are entered correctly. 

Don’t overlook the semicolen appearing in line 30 after the 
PRINT# command. In a future issue we’ll show you how to use 
more DOS ROM routines, and A an easier way to 
construct utility loaders. Until then, easy DOS 1t! 


(Mike Gilsdorf can be reached on Q-Link under the handle 
MIKE ALL). 

Faster than a Speeding Cartridge 
: More Powerful than a Turbo ROM 


It's Fast, It's Compatible, It's Complete, It's... 


JiffyDOS 


Ultra-Fast Disk Operating System for the C-64, SX-64 & C-128 


« Speeds up all disk operations. Load, Save, Format, Scratch, Validate, access 


PRG, SEQ, REL, & USR files up to 15 times faster! 

« Uses no ports, memory, or extra cabling. The JiffYDOS ROMs upgrade your 
computer and drive(s) internally for maximum speed and compatibility. 

» Guaranteed 100% compatible with all software and hardware. JiffyDOS speeds 
up the loading and internal file-access operation of virtually all commercial software. 

* Built-in DOS Wedge plus 14 additional commands and convenience features 
including one-key load/save/scratch, directory menu and screen dump. 

» Easy do-it-yourself installation. No electronics experience or special tools re- 
quired. |llustrated step-by-step instructions included. 


Available tor C-64, 64C, SX-64, C-128 & C-128D (JiffyDOS/128 speeds up both 64 
and 128 modes) and 1541, 1541C, 1541-W, 1571, 1581, FSD-1&2, MSD SD-1&2, 
Excel 2001, Enhancer 2000, Amtech, Swan, Indus & Bluechip disk drives. System 
includes ROMs for computer and 1 disk drive, stock/JiffyDOS switching system, 
illustrated installation instructions, User's Manual and Money-Back Guarantee. 





Please add $4.25 shipping’handling per order, plus $2.50 for AK, HI. APO, FPO, 
Canada & Puerto Rico. $10.00 add'l for other overseas orders. MA residents add 5% 
gales tax. VISA’MC, COD. Check. Money Order Allow 2 weeks for personal checks. 

Call or write for more information Dealer. Distributor & UG pricing available. 


Please specify computer and drive when ordering 


« Creative Micro Designs, Inc. 


C-64/SX-64 systems $59.95; C-128/C-128D systems $69.95; Add’l drive ROM's $29.95 L 


P.O. Box 789, Wilbraham, MA 01095 Phone: (413) 525-0023 = 
50 Industrial Dr., Box 646, E. Longmeadow, MA 01028 FAX: (413) 525-0147 





Our Fourth Year 
In Business! 
We Know How 
To Service 
Our Customers! 





40/80 Column Switch Cable 
Apro Ext.64-Crt. Port Ribbon 
Apro Ext.64-User Port Ribbon 
Aprospan 4 Stot Cartrdg Holder 
Cover 1541 

Cover 1571 

Cover C128 

Cover C64 

Drive Box 

Final Cartridge V3 

Hotshot Pius interface 
Joystick-Bat Handle 
Joystick-Ergo Stick 
Joystick-Super 3 Way 

Joystick Y Adapter 

Leroy’s Cheat Sheets C64 each 
Leroy’s Cheat Sheets C128 each 
Lightpen-Mode! 170c 
Lightpen-Mode! 184c 

M-3 Mouse 64/1 28-Proport. 
Mach 128 Cartridge 

Mousepad 

Paper Banner Colors each 
Power Supply-C128-Repairable 
Power Supply-C6 4-Repairable 
Quick Brown Box 32K 

Quick Brown Box 64K 

RGB to RCA Cable 

RS232 Deluxe Intertace 
Ribbons for Printer 

Ribbon Renew Re-Ink w/no eqp. 
Serial Box 2 for 1 

Serial to Serial Cable-6 ft. 
Super Chips 128 

Super Chips 128-D 

Super Chips 64 

Super Chips 64 mode on 128 
Super Graphix Gold Prntr Intric 
Warpspeed 128 


1541 Troubleshoot & Repair Guide 17 


1571 Internals * 17 
Anatomy of C64* 17 
Anatomy of the 1541 Book 17 
Basic 7.0 Internals Book 19 
Basic 7.0 for C128 Book 10 
Beginner's Guide to BASIC 8 15 
C128 Assembly Language Prog Book 14 
C128 Internals * 17 
C128 Programmer's Ref. Book 20 
C128 Tips & Tricks Book 17 
C128 Troubleshooting & Repair Book 17 
C64 Basic Programming 25 
C64 Programmer's Reference Guide 17 
C64 Tips & Tricks* 17 


C64 Troubleshoot & Repair Guide 17 
(64/128 Asmbly Lang. Prog Book 14 


GEOS Get Most Book 9 
GEOS Inside & Out’ 17 
GEOS Programmer's Ref.Guide 17 
GEOS Tips & Tricks* 15 
Hot to Program in BASIC 24 
| Speak Basic to My C64 Book 8 
K Jax Book Revealed 2 23 
K Jax Book Revealed 1 23 
Machine Language 64 Book 13 
Superbase The Book 64/128 15 


Troubleshoot & Repair C64 Book 18 
Twin Cities 128 Compendium 1 15 
Abacus Disks each* 12 





Bankstreet Writer 35 
Business Form Shop/6 4 30 
CMS Accounting/128 . 129 


CMS Inventory Module 128 53 


_Chartpak 128 











BAIWALL 


SOLID PRODUCTS & SOLID SUPPORT 


P.O. Box 129 / 58 Noble Street 


Kutztown, PA 19530 


24 HOURS — TOLL FREE 
1-800-638-5757 


Chartpak 64 
Datamanager 128 
Datamanager 2 (64) 

Fleet System 2 + /64 
Fieet System 4 
Fontmaster 128 w/Speller 
Fontmaster 11/64 
KFS Accountant 128 
Leroy’s Labe! Maker 
Microlawyer/64 
Paperclip 3 
Paperclip Publisher 
Partner 128 

Partner 64 

Personal Portfolio Manager 128 
Personal Portfolio Manager 64 
Pocket Dictionary 64/128 
Pocket Filer 2 

Pocket Planner 2 

Pocket Superpak 2 

Pocket Writer 2 

Security Analyst 128 

Superbase 128 

Superbase 64 
Sprbase/Sprscrpt/Book 128 PAK 
Sprbase/Sprscrpt/Book 64 PAK 
Superscript 128 

Superscript C64 

Swiftcalc 128 w/Sideways 


a 





Swiftcaic 64 w/Sideways 

Syivia Porter's Financial Plan 128 
Technical Analysis System 128 
Technical Analysis System 64 
Timeworks Account Payable 64 
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Timeworks Accounts Receiveabie 64 39 


Timeworks General Ledger 64 


39 


Timeworks Inventory Managemnt 64 39 


Timeworks Payroll 64 
Timeworks Sales Analysis 64 
Vizistar 128 

Viziwrite 128 

Wordpro 128 w/Spelter w/Fitepro 
Wordpro 64 w/Spelter w/Turbo Load 
Wordwriter 128 

Wordwriter 3 for C64 

Write Stuff 64 

Write Stuff 64 w/Talk 

Write Stuff C128 Version 





Caiculus by Numeric Methods 
Counting Parade 
Designasaurus 

Early Learning Friends 

Easy Sign 

Evelyn Wood Dynamic Reader 
Facemaker 

First Men on Moon Math 
Grandma's House 

Hayden SAT Preparation 
Jungle Book (Reading 2) 

Kids on Keys 

Kidwriter 














Kindercomp 
Linkword: German 19 
Linkword: French 19 


Linkword: French 2 19 
Linkword: Italian 19 
Linkword: Russian 19 
Linkword: Spanish 19 
Littke Computer People 12 
Mathbusters 6 


Mavis Beacon Teaches Typing 30 
Peter & Wolf Music 19 
| Peter Rabbit (Reading 1) 19 
Protutor Accounting 128 69 
R.S.V.P. 21 
Sky Travel 35 


Stickybear ABC's 22 
Stickybear Math 1 22 
Stickybear Math 2 22 
Stickybear Numbers 22 
Stickybear Opposites 22 
Stickybear Reading 1 22 
Stickybear Reading Comprehension 22 
Stickybear Shapes 22 
Stickybear Speligrabber 22 
Stickybear Townbuiker 22 


| Stickybdear Typing 22 


Success w/Math Series each 23 
Toy Shop 64 22 
WhereinEurope is Carmen Sandiego 29 
Where in USA is Carmen Sandiego 29 


Where in World is Carmen Sandiego 29 
Widham Classics-Alice/Wonderiand 32 
Widham Classics-Below the Root 12 
Widham Classics-Swiss Famly Robs 12 
Widham Classics-Treasure Island 12 
Widham Classics- Wizard of 0Z 


Becker Basic for GEOS 64 

Desk Pak Plus-Geos 22 
FontPak Plus-GEOS 22 
GEOS 64 v 2.0 39 
GEOS Programmer/64 45 
GEOS Write Workshop/6 4 39 
GEOS Write Workshoo/1 28 45 
Geocalc 128 45 


Geocalc/64 35 









Geospell 64/128 
Wordpublisher 64/128 (for GEOS) 28 








Animation Station 


Award Maker Plus/C64 29 
Biltboard Maker/64 25 
Blazzing Paddtes 25 
Bumpersticker Maker 35 
Business Card Maker 29 
Button & Badge Maker 39 
Cad 3D/64 39 


Cadpak 128 42 












_ OUTSIDE USA CALL 1-215-683-5433 


Cadpak/64 29 
Certificate Maker 17 
Certificate Maker-Library 12 
Colorez 128 12 
Computer Eyes 105 
Create a Calendar 22 
Doodle/64 29 
Flexidraw 5.5/64 29 
Flexifont/64 24 
Graphics Art Disk 7-12 each 9 
Graphics Galleria Pak 1 24 
Graphics Gaileria Pak 2 24 
Graphics Intergrator 2/64 24 
Home Designer 45 
Home Designer/Circuit Symbol Lib 10 
icon Factory/64 25 
Labei Wizard 21 
Newsmaker 128 24 
Newsroom 17 
Newsroom Clip Art Disk 1-3each 13 
PC Board Maker 64 79 
Perspectives 11/6 4(3D) 39 
Photo Finish 19 
Postcards 19 
Printmaster-Fantasy Art Gallery 15 
Printmaster Gallery 1/64 15 
Printmaster Gallery 11/64 15 
Printmaster Plus/64 25 
Printshop/64 35 
Printshop Companion 





Screen F/X 


Sketchpad 128 NEW 24 
Slideshow Creator 13 
Video Title Shop w/Gr Comp 1 25 


Video Title Shop s/Gr Comp 2 17 


Boston Bartender’s Guide | 
Bridge 5.0 22 
Cardio Exercise 75 


Cardio Exercise & Heartlab Combo 85 | 


Celebrity Cookbook/6 4 19 
Dr. Ruth's Book of Good Sex 22 
Dream Machine Analyze/64 19 
Family Tree 128 39 
Family Tree 64 39 
Heartiab 49 
MK America Cooks Chinese 12 
MK America Cooks Italian 12 
MK Great Chefs of PBS Vol 1 12 
MK Great Chefs of PBS Vol 2 
MK Great Chefs of PBS Vol 3 12 
Memory Academy 128 15 
Micro Kitchen Companion 29 
Monopoly C64 25 
Muscle Development Package 54 
Sexual Edge/64 19 
Stress Reduction-Enhanced 299 
Stress Reduction-Standard 89 
Strider’s Classic 1-10 each 5 
Tarot 128 15 









1541/1571 Drive Alignment 25 
1581 Toolkit 32 



















SATISFACTION 
GUARANTEED 


No Surcharge On 
Charge Orders 


Friendly Service 


OLUIS) COVANTs@ueysavalels 


SLUSTLALSSSIoME ML OLUT ES 
M-F, 9-5 EST 


Assembier/Monitor/6 4 
Basic 8 

Basic Compiler/128 

Basic Compiler/64 

Big Blue Reader 64/128 
Bobsterm Pro/128 
Bobsterm Pro/64 

CP/M Kit 

Cobol/1 28 

Cobol/64 

Gnome Kit 64/128 

Gnome Speed Compiler 128 
Kracker Jax Super Cat 
Kracker Jax-Hacker’s Utilities 
Merlin 128 

Merlin 64 

Oxford Pascal 128 

Oxford Pascal 64 

Physical Exam 1541 
Physical Exam 1571 
Power Assembier 64/128 
Power C 64/128 
Programmers Tooibox/64 
Protolinc BBS 128 
Prototerm 128 

RamDOS 128 
RenegadeCopier V2 

Super 64 Librarian 

Super 81 Utilities for C128 
Super 81 Utilities for C64 
Super Aide 64 

Super C 128 

Super C 64 

‘Super Disk Librarian for C128 
Super Disk Utilities 128 
Super Pascal 128 

Super Pascal 64 

Super Snapshot 4 w/C128 Disable 
Super Snapshot V4 
SysRES Enhanced 

Z 3 Plus 





AD&D Dungeon Master Assistance 


AD&D Pool of Radiance 
Alf 

Battleship 
Blackjack Academy 
Catifornia Raisins 
Caveman Ugh *tympics 
Chessmaster 2001 
Crossword Magic 
Double Dragon 
Faery Tales 
Jeopardy 2 

Jordan vs Bird 

Lord of the Rising Sun 
Main Frame 
Monopoty 
Newromancer 
Ocean Ranger 
Operation Wott 
Ptatoon 

Powerplay Hockey 
Rampage 

Rocket Ranger 
Roger Rabbit 
Scrabble 

Scruples 

Skate or Die 

TV Sports Football 
Three Stooges 
Ultima V 

Wheel of Fortune 2 
Zach Macrakin 
Zoom 









Home Designer 


When the detailvareimportant! 


Home Designer CAD 128 

Given glowing ratings by every major Commodore 
magazine, this CAD system outclasses every 
other CAD program, because of its object-based 
design. With over 50 powerful commands, 5 
drawing layers, superb support of library figures 
and lazer-quality printouts at ANY scale on your 
dot matrix printer or plotter, you can create 
drawings so accurate that a blueprint can be made 
from them! 

Tired of working with poor quality/inaccurate print- 
outs, manipulating little dots on a bit-map, giving 
up on detailed work because you can’t zoom in 
close enough? Join the professionals! 


only $45.00 


mouse or joystick required 
NEWIEngineering Library disk available now. $10.00 


SIZZLING HOT 
ENTERTAINMENT TITLES 
















Brand new from Free Spirit, Sketchpad 128 fully 
supports your C128 and takes advantage of its 
crisp 80 column graphics capabilities. It is packed 
with all the features of a professional drawing 
package such as drawing SMOOTH freehand lines, 
3D Solids, creating Slideshows, Cut & Paste, Clip, 
Flip, Enlarge, Shaded Fill Patterns, a variety of 
Fonts, Air Brush and more! It supports Printshop 
graphics and is completely compatible with all 
BASIC 8 files. 

Sketchpad 128 unleashes the graphics power of 
your C128! It supports your 1351 Mouse, 64K 
Video Chip, 1581 drive and 80 column display. 
What more could any real C128 user ask for? 


ONLY $24.00 









ro 


‘NEWS MAKER 128 | 


Finally somebody (Free Spirit Software) has 
introduced a desk top publishing program for the 
128 in its native mode! Take a few moments: to 
think about what should be included! Would you 
like the crisp & clear 80 column screen? Would 
you like to zip across the screen with a 1351 
mouse? Could you use a Ram Disk that can store 
multi-page documents & graphics available at the 
click of a mouse? Also how about Storing up to 45 
fonts in the Ram Disk for instant access? How 
about if you could use Print Shop graphics directly 
from the Print Shop disk? Also be able to use 
pictures and graphics created with Sketchpad 128 

and Basic 8.0. Wouid you prefer graphic tools that 

would allow you to draw custom art directly? How 

about supporting 2 text modes and 9 font sizes? 

Pour sequential files into columns? Adjust 
columns around graphics! or type text directly to 




















AD&D Dungeon Master Assistance... ss stsisisiss wis $22 the screen? 

AD&D Pool of Radiance. ss ws 29 

Battleship = 24 ONLY $24.00 
Caveman Ugh*lympics. 22 


Double Dragon Nite ASS ee oh rete 8 oe acetate 
Jordan vs Bird . Bt eo Ak 
Lord of the Rising Sun —si«w«ti( wt. Pies eporek bi tases 


Monoply C64 fee ph G ES PEG Teo lone Rares 


Newromancer te es eee ee 29 
Operation Wolf a3 RS Fw GRE Lene eouicngad eS 
Platoon o Ri ete th ad anette is. hee pee 
Powerplay Hockey. .—-«..—s—=a'—«swsisa‘aés‘(«wst oo... 24 
Rampage ee: ae ee ee Pee ee ee 27 
Rocket Ranger 4 Su 08 ef 7 - . 27 
Roger Rabbit shes te einer, © ae & bien at VO 
Scrabble vad wre Sais eh Mathes ... 26 
Scruples ee er ere ee. 
Skate or Die 8 Soh a to iene le ee 22 
TV Sports Footbal 25 
Three Stooges sia (ti sak Hd eA Ane aot hed doe’ 27 
Ultima V SASL ORO oe no aoe Gat sake 42 
Zach: Wacrakil «235 ence eles 4 ee tte ele oe ae 25 
Zoom 22 


Buy any 3 of the above titles 
and deduct $5 from your order total! 
Offer until 3/31/89. 


1541/45/74 

Oxive Auvonivicre: 
1541/1571 Drive Alignment 
This excellent alignment program is a must have 
for every Commodore owner. Easy to use, it helps 
you to align your drive so that it runs just as if it 
were new! The simple instructional manual and 
on-screen help prompt you thru the alignment 
procedure and help you adjust the speed and head 
Stop of your drives. It even includes instructions 
on how to load the alignment program when 
nothing else will load. Don’t be caught short! We 
get more RED LABEL orders for this program, then 
any other program we sell. Save yourself the 
expense! Order now, keep it in your library and 
use the 1541/1571 Drive Alignment program 
regularly! Works on the C64, C128, and SX64 for 
both the 1541 and 1571 drives. 


Sra wl 325. 00 


ae ‘ORDERS received betore 3PM a 
| items will be shipped by the same 

| Alt UPS. shipments are sent SIGNA) 
| Charges to your TOTAL software ore 
UPS: Ground $4.00 {cont USA ONLY); Aic/Rush $7, 00 ct 
~ $2.50 per item (must be received by 12 NOON 









Actual Shipping (minimum a2. 60) 


ORDERING INSTRUCTIONS 










































INEW PACKAGING! 
INEW SUPPORT! 





This popular package adds extensive 80 column 
graphics capabilities to your C128. A must for 
C128 programmers! As an added bonus several 
preprogammed BASIC 8 applications, such as 
BASIC PAINT, WRITE and CALC, are included on 
the flip side! 





Free Spirit = JUST $29 


Sofware ix =a 
tte 


- : a ee a i: ; é : os ' 
MAIL: USA $4.00 (includes APO/FPO); CanadalMexico $ $6 00: ¢ Ofer Fre $4 00 {ann ae it 













C128D (or 64K video) and 
80 column monitor 











SCREEN 


Create incredible presentations using 100,000 
different combinations of effects. Create fantastic 
animated scripts using the most powerful C64 
editor ever created. 


OUR PRICE $25 





Convert, Enlarge, Alter, Enhance, Crop, Invert, 
Flip, Reduce and even Smooth graphics with this 
great graphics conversion utility. 


OUR PRICE $25 





“Optimize” your Hi-Res graphics producing 
hardcopy with FOUR TIMES the resolution of 
standard printer dumps. 


OUR PRICE $19 











1. supPORT 
We do our v : 
1-800-638-5757. Outside the USA, please use (215) 683-5433. Price, ‘Availability and Compatability product. aenalch te 
Checks are also welcome on our order line, Monday thru Friday, 9:30AM -4:30PM EST. AFTER HOURS. _at the time. bgp fer 2 
Orders Only, Please!! When placing an order, please — Computer Model, Home & Daytime Phone compa 
Number, Shipping Address, Charge Card Number, ExpirationaDate, & Name of Bank. To /~ us Serve bi! 215-683- 5¢ 99" Call 
better, please have all your information réady betore you call ma help you. 


For your convenience, you can place a phone order 24 HOURS/7 DAYS A WEEK on our TOLL-FREE LINE | 






SSS gun Ch 
| ee es ae Issue #24 Page 23 
== == Sef ee eee 


Ss 






by Rick Kane 
he C-128’s programmable function keys can be a handy and 
welcome feature for power users. It’s possible to spece 
many operations by simply redefining a key or two for your 
articular needs. I’m sure most of us already have the 
perfect’ set of definitions for our tastes. 


But there are a couple of areas that the ’key’ command 
doesn’t address. What about the HELP and shift-RUN/STOP 
keys? These are also programmable keys, but the ’key’ 
command will not let you near them. And what about programs 
that use the function ae ina menu? They expect the ehrs 
codes from 133 - 140. If you’re testing an oe pueen such 

a program, it can be a problem. You have to define the 
function keys as the chr$ codes (you probably should at the 
beginning of such a program anyway), then you have to 
retrieve your programming-aid definitions each time you test 
a change you’ve made. You could write that into the program 
you’re working on, but that clutters things up (I think) 
unnecessarily. 


Yes, the Lod command is powerful and useful, but it simply 
doesn’t go far enough. What it needs is an enhancement that 
allows you to redefine the HELP and shift-RUN/STOP macros. 
An enhancement that allows you to toggle between the 
definitions YOU want and the ones the program wants. What 
it needs, if you haven’t figured it out by now, is 
"FKEY.POWER,, the subject of this article. 


When ’FKEY.POWER’ is loaded and run, you will get a list of 
acy command enhancements, followed by ’fkeys:on”. An 
definitions you had entered are intact, and are considere 
the ’on’ keys. If you ee *key’ <return>, you will see 
them ( not the HELP or shift-RUN/STOP macros). Now type 
"key off <return>, The space is not needed, but be sure 
you start at the poe? the line, or you will geta _ 
syntax error. Then type key’ <return> again. You will see 

e graphic symbols for the chr$ codes 133 - 140. HELP is 
defined as ’help’ < return >, and shift-RUN/STOP as ’run"*’ 
<return >, and these work as on power-up. Type ’key on’ 
. en >, then ’key’ <return>, and your definitions are 

ack! 


To redefine the shift-RUN/STOP key type ae | 9,” followed by 
our definition, the same way you do for keys 1-8. | 
imilarly, the HELP key is defined with ’key 10,’ . This 
work for either the ’on’ or ’off’ key definitions, but 
there is one thing to keep in mind. The ’off keys are 
stored in an area of 40 bytes. The first ten are ey 
lengths for each key, leaving 30 for definitions. Eight are 
used by the function ope as defined, caving 22 bytesfor _ 
HELP and shift-RUN/STOP. These use 11 as defined, leaving 
11 ’spare’ bytes for changing the ’off definitions. oa 
extra will overwrite some ae of your ’on’ macros (if they 
are longer than 40 themselves), so be careful if you 
redefine the ’off keys. Any changes you do make are 
swapped into the ’olf buffer with the next ’key on’, so 
they could be saved with the machine language if you prefer 
' different set of definitions. I’ll say more about that 
ater. 


The last new command, ’key x’, disables the enhanced 
commands, leaving whichever set was working intact. To 
re-enable FKEY. POWER, type ’sys3072’. (If you type 
’sys3072’ when seer ke is active, it will be disabled. 
Just type it again.) If ’key off was issued before ’key 

x’, a ’key on’ command issued now will restore your ’on’ 
definitions, if they haven’t been overwritten; most likely 
by a boot’. If the keys were left ’on’ before LOks the 
current definitions will be the new ’on’ keys. F -POWER 
Should be quite transparent, but if you want to testa _ 

Ee ae change in a program that is sensitive to it, 

issue a ’key off before ’key x’, run the test, then type 
’sys3072’ to re-enable fkeys, and ’key on’. This will bring 
back the definitions you were using before the test. If you 
aren’t sure whether the keys were off before disabling, you 
can bring back the working macros by ’poke 3260,0’ before 


FKEY POWER 


the ’sys 3072’. FKEY.POWER works by intercepting the 
ERROR vector. On an error, it looks at the input buffer, 
looking for the ’key’ token. If it was a syntax error, it 
checks for the ’x’ character at the point of the error, and 
disables itself if found. If not, it looks to define key 9 
RUN/STOP) or 10 (HELP). If ’9’ caused the error, it 
efines key 9, otherwise it defines key 10 . It does so b 
re-entering the PFKEY routine where it exited to the ERROR 
routine. ’key on’ and ’key off cause the ’unimplemented 
command’ error. In this case, FKEY.POWER checks for the 
tokens for ’on’ or ’off’. If off caused the error (and 
the keys are on), it stores the first 40 bytes at $1000, the 
current definitions, to KEYON ($0bd8 - $0bff), and installs 
the chr$ code definitions from KEYOFF ($0cb8 - $0cff) to 
$ . If’on’ caused it, and the keys were already off, 
it swaps out the ’off? keys to KEYOFF and installs KEYON 
back to $1000 , reuniting those 40 bytes with the ’on’ 
definitions. The length bytes reflect the length of these 
definitions, and 40 captured bytes fit back into place. 


If you want, you can save the machine language as a bootable 
file, one which can be activated without disturbing Basic 

with ’boot "name". This also allows you to save any 

changes you might make to the ’off definitions, just type: 


KEY ON <RETURN> 
BSAVE"NAME" ,P(3072)TO P(3328) ,BO 


If your ’on’ definitions are 40 bytes total or less, you can 
save them with the machine language with the following: 


KEY OFF <RETURN> 
POKE3029, 76: POKE3030,0: POKE3031,12 <RETURN> 
BSAVE" NAME" ,P(3029)TO P(3328),BO <RETURN>. 


The pokes above create a ’jmp $0c00’ at the start. The file 
created will then boot normally, and your ’on’ keys will be 
available immediately. 


See listings on Page 24 





Testa Zéittes 128 


Touraal, P.o. BOX 11578 
MINNEAPOLIS MN 554i 







while the 
others are shrinking ! 


Six is44ne4 $12.50 
Twelve i444n0e4 $25 









Twin Cities 125 Compendium 
Book Hi the Best of taraesa 
BPO, DS 
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=e FKEY POWER 
Continued from Page 23 
* FKEY.POWER 2.1 x KEYTOGL CPX #$28 ;UNIMPL. COMMAND ERROR 
* MERLIN SOURCE CODE * BNE DONE 
LDY TXTPNTR 
TXTPNTR = $3D LDA BUF,Y 
BUF = $0200 CMP #$24 72ND BYTE OF 'OFF' TOKEN 
IERROR = $0300 BNE KEYON 
PKYBUF = $1000 KEYOFF LDX ONFLAG 
PFKENTRY=  $60EC BEQ OFFDONE 
PRIMM = $FF?D LDX #$DO0-KEYOFFS ;# BYTES IN KEYOFFS 
OFFLOOP LDA PKYBUF-1,X 
STA KEYONS-1,X 
ORG $0CO0 LDA KEYOFFS-1,X 
STA PKYBUF-1,X 
JSR PRIMM DEX 
HEX OD BNE OFFLOOP 
TXT '<C>89 R.KANE! STX ONFLAG 
HEX OD OFFDONE DEX 7NO ERROR MESSAGE 
TXT "KEY9/10/ON/OFF/X' RTS 
HEX ODOO 
TOGGLE JSR PRIMM ONFLAG HEX FF 7FF =ON TO START 
TXT 'FKEYS:' 
HEX 00 KEYON LDX ONFLAG 
BNE ONDONE 
LDX IERROR LDX #$0D00-KEYOFFS 
LDY IERROR+1 ONLOOP LDA PKYBUF-1,X 
CPX #<TRAPERR STA KEYOFFS-1,X 
BNE INSTALL LDA KEYONS-1,X 
CPY #>TRAPERR STA PKYBUF-1,X 
BNE INSTALL DEX 
LDX ERRVEC BNE ONLOOP 
STX IERROR DEX 
LDX ERRVEC+1 ONDONE STX ONFLAG 
STX IERROR+1 RTS 
JSR PRIMM 
TXT ‘OFF! KEYOFFS HEX 01010101010101010605 
HEX 00 HEX 8589868A ;FUNCTION KEYS 1-4 
LDX #$FF HEX 878B888C ;FUNCTION KEYS 5-8 
BNE DONE HEX 52D5222A0D 7 'RUN"*' <RETURN> 
INSTALL STX ERRVEC HEX 48454C500D ; 'HELP'<RETURN> 
STY ERRVEC+1 
LDX #<TRAPERR KEYONS = KEYOFFS-$100 
STX IERROR 
LDX #>TRAPERR BASIC LOADER FOR FKEY.POWER 
STX IERROR+1 
JSR KEYON 10 REM FKEY.POWER V2.1 
JSR PRIMM 20 REM <C> 1989 RICK KANE 
TXT ‘ON! 30 TRAP 60 
HEX OO 40 RESTORE: I=DEC("O0COO") : X=0 
DONE RTS 50 DO:READ A$: POKEI+X, DECCA$) : X=X+1: LOOP 
60 SYS I 
TRAPERR JSR NEWERROR 70 END 
HEX 4C ; SMP 100 DATA 20,7D,FF,0D,3C,43,3E,38,39,20,52,2E,4B,41,4E,45 
ERRVEC HEX 3F4D 110 DATA 00,4B,45,59,39,2F,31,30,2F ,4F,4E,2F ,4F,46,46,2F 
120 DATA 58,0D,00,20,70,FF,46,4B,45,59,53,3A,00,AE,00,03 
NEWERRORLDA BUF 130 DATA AC,01,03,E0,6D,00,1B,CO,0C,D0,17,AE,71,0C,8E,00 
CMP #$F9 ;'KEY' TOKEN 140 DATA 03,AE,72,0C,8E,01,03,20,7D,FF,4F,46,46,00,A2, FF 
BNE DONE 150 DATA DO,1A,8E,71,0C,8C,72,0C,A2,60,8E,00,03,A2,0C,8E 
CPX #$0E ; SYNTAX ERROR 160 DATA 01,03,20,BD,0C,20,7D,FF,4F,4E,20,00,60,20,73,0C 
BNE KEYTOGL 170 DATA 4C,3F,4D,AD,00,02,C9,F9,00,F2,E0,0E,D0,16,A2,09 
LDX #$09 180 DATA A4,3D,B9,FF,01,C9,58,F0,9A,C9,39,00,01,CA,20,EC 
LDY TXTPNTR 190 DATA 60,A2,FF,60,£0,28,00,04,A4,3D,B9,00,02,C9,24,D0 
LDA BUF-1,Y 200 DATA 1C,AE,BC,0C,F0,14,A2,28,BD,FF,OF,90,07,0B,BD,D7 
CMP #'X' 210 DATA OC,90,FF,OF,CA,DO,F1,8E,BC,0C,CA,60,FF,AE,BC,0C 
BEQ TOGGLE 220 DATA 00,12,A2,28,BD,FF,OF,90,D7,0C,BD,D7,0B,9D, FF ,OF 
CMP #'9! 230 DATA CA,D0,F1,CA,8E,BC,0C,60,01,01,01,01,01,01,01,01 
BNE DEFINE 240 DATA 06,05,85,89,86,8A,87,8B,88,8C,52,55,4E,22,2A,0D 
DEX 250 DATA 48,45,4C€,50,0D 
DEFINE JSR PFKENTRY ,CONTINUE KEY DEFINITION 
LDX #$FF ;X>127 = NO ERROR 


RTS 





Za Gree esd Issue #24 Page 25 


Sparrow’s Slick Tips 


by Sparrow James? 
After a few issues on hiatus, the tricky bird returns with a few slick ones... 


CLIP...CLIP...PAPERCLIP... One of the nicest things about C-128 programs which are not copy protected is the ease at which 
most of them can be adapted to alternative mass stotaee situations such as the RAMDOS and probably more importantly, the 1581 
disk drive. One such program is Paperclip III from Electronic Arts. What is particularly attractive about this prospect 1s 
the fact that by virtue of the 1581’s large storage capacity you can place all of Paperclip’s "overlay" files and its entire 
dictionary onto a single 1581 disk and still have ample room for documents. In addition, by virtue of Paperclip III’s non-copy 
rotected state you can hide these system files in a partition so they are not cluttering your main (root) directory. Here is 
ow you accomplish this feat: First format a fresh 1581 disk. Then using the peruuicn creation utility on the 1581 test/ 
demo disk, or any other partition creation utility create a disk panuon of at least 1200 blocks and format the partition. 
Then use a file copier to copy the Paperclip program/overlay files, your printer configuration file, and the Paperclip 
dictionary files into the partition you just created. Then place the following BASIC program in your root directory: : 


10 U=PEEK(186) 
20 FAST:OPEN,15,U,15,"/0:PCLIP" 
30 DLOAD"PCIII128G/RC" ON UCU) 


(Note, If you do not have a RAM Expansion Unit, the filename in line 30 should read: PCIIII28G) Running the above program 
automatically selects your eeperelp partition (in this case called "pclip") and loads the program and its overlays from the 
pclip partition. Once Paperclip is loaded, you can then use the Commodore DOS "I0" command (via the control > option) to 
return to your root directory. REU owners may want to load the dictionary into the REU before exiting the pclip directory. 


BIRDS JUST WANT TO HAVE FUN... You know sometimes the staff at Twin Cities 128 is so ue up with interlace whatchamacallits, 
and high level conversations with C-128 heavy weights, that they just plain forget to loosen up and have a little fun with 
their C-128s! That is why I wrote this little program and slipped it in the issue while Loren and Frank were not looking. 


10 WR=52684: RR=52698: SCNCLR: WINDOW 20,10,60,20,1 

20 PRINT:PRINT"LADIES AND GENTLEMAN. ..":PRINT:PRINT"SUBMITTED FOR YOUR VIEWING PLEASURE": PRINT 
30 PRINT"A FEW NIFTY 80 COLUMN TRICKS":PRINT:GOSUB 390:SLEEP 1 

40 PLAY" TOO4HASBBBHAWB": SLEEP 2:SCNCLR:GOSUB 590:WINDOW 10,10,40,20,1:PRINT"GEEZ...1 FEEL FAT!!!":PRINT"TIME TO GO ON A DIET!" 
50 PLAY"O4T7HAAO2WSE": SLEEP 3:GOSUB 630:GOSUB 390:PRINT:PRINT"OH YES..THAT IS MUCH BETTER..." 
60 PLAY"O2T7HAAOGWSE": SLEEP 2:WINDOW 0,10,79,20,1 

70 PRINT: PRINT"WAIT A SEC..I AM NOT FEELING SO GOOD...1 FEEL AS IF I AM ABOUT TO DISAPPEAR! !!":SLEEP 2 
80 PLAY" T205HGW.O3BT3SOSAAAAAAAAAA":GOSUB 450:SLEEP 2:SCNCLR: PLAY" T3SOSAAAAAAAAAA" 

90 PRINT: PRINT: PRINT"AH...I AM COMING BACK NOW...YOU HAVE TO BE CAREFUL WITH THOSE CRASH DIETS" 
100 GOSUB 520: PLAY" TOOGHASBBBHAWB": SLEEP 2 :WINDOW 0,0,79,24,1 

200 END 

390 REM CHARACTER SWIPE 

400 FOR L=0 TO 8:SYS WR,L,23 

410 FOR X=1 TO 100:NEXT X 

420 NEXT L 

430 RETURN 

450 REM CLOSE CURTAIN 

460 FOR L= 100 TO O STEP -1:SYS WR,L,35 

470 FOR X=1 TO 10:NEXT X:REM DELAY LOOP 

480 NEXT L 

490 RETURN 

520 REM OPEN CURTAIN 

530 FOR L= 0 TO 100:SYS WR,L,35 

540 FOR X=1 TO 10:NEXT X:REM DELAY LOOP 

550 NEXT L 

560 RETURN 

580 REM 40 COLUMNS? 

590 SYS WR,63,0:SYS WR,40,1:SYS WR,55,2:SYS RR, ,25 

600 RREG A:SYS WR,(A OR 16),25:SYS WR,137,22:SYS WR,40,27: POKE238,39 

610 RETURN 

630 REM BACK TO 80 

640 SYS WR,126,0:SYS WR,80,1:SYS WR,102,2:SYS WR,120,22 

650 SYS RR,,25:RREGA:SYS WR,(A AND 239),25:SYS WR,O,27 

660 POKE238,79 

670 RETURN 


Sparrow’s Parting Shots... I suspect that once they realize that I pulled the fast one above, I will be put back in my cage for 

a long, long time. But before I go, here is a few parting words o advice: 1, Get in the habit of setting your clock on the 

GEOS 128 v2.0 desktop, everytime you boot it! GEOS automatically will time and date stamp your files, and now that Berkworks 
has made setting the clock from the desktop so eri there is no reason not the utilize this powerful feature. 2. Remember 

that the latest version of Superbase 128 (version 3.0) in addition to supporting the 1581 disk drive, supports expornne 

pep eke ant rat finding, and outputting between multiple disk units! Also, the Superbase utility program now works in 128 
mode making it much faster! If you have not upgraded you don’t know what you are missing. Contact: Precision Software, 8404 
Sterling Street - Suite A, Irving X 75063, 214-050-4888) As the blinking cursor fades...rcemember what your C-128 says: 

"Link Arms Don’t Make Them!" 





Jwin Ches 128 
—— The Commodore 128 Toaraal 





by Anton Treuenfels 

here are times (often shortly after scratching a file I 
really didn’t mean to) when I find it very useful to have a 
disk monitor program handy. Using one of these widely 
available programs I can examine and, if I wish, modify the 
contents of any disk sector. On the other hand’ I felt that 
many of these programs were big, clumsy, rigid, and 
inconvenient to use. The program presented here was 
designed to overcome these perceived problems. Although it 
does not do evens ae could possibly be wished for, it 
is relatively small, nimble, flexible, and easy to use. 


A disk monitor program must at least be able to read, write, 
display and edit disk sectors. The problems of display and 
editing are shared by monitor programs in eae and 
"DISKMON128 deals with them by wedging itself into the main 
command loop of the C128’s built-in machine language 
monitor. This reduces display and editing to problems that 
have already been solved (always a nicetall programming 
technique). As bonuses DISKMON128 gains use of the "@" disk 
wedge command and the ability to examine and modify sectors 
by disassembly and assembly as well as by simple memory 
dump. After ape so much of the power of the built-in 
monitor, about at is left for "DISKMON128 to concern 
itself with is the proper reading and writing of disk 

sectors to and from the C128’s memory. 


USING THE PROGRAM: 
This version of DISKMON128 is designed to work with RLO, a 
linking loader program for Merlin 128 format link files. A 
eyo. DSKMON128.RLO.O must be attached to a copy of 
RLO128.0 (eg., by using the DOS command 
"c0:diskmon128 = rlo128.0,dskmon128.rlo.o") to function 
proper): The ue program may then be LOADed and RUN 
ke any normal BASIC 7.0 program (a caution: the bitmapped 
graphics area must not be in use at the time). DISKMON os: 
is installed into the C128’s free RAM block which starts at 
$1300 in bank 0. 


DISKMON128 functions as an extension of the C128’s built-in 
machine language monitor. When operating within the monitor 
there are four new commands in addition to all the usual 

ones: 


/R[<track> <sector>] - read sector 

/W|<track> <sector>] - write sector 

/# <device > [<drive >] - set device and drive numbers 

/Q - disable disk monitor wedge 

All parameters are numeric and (since a built-in monitor ROM 
routine is used to collect them) may be specified in any 
convenient base (hexadecimal, decimal, octal, or binary). 
Square brackets indicate optional parameters. 


The read command ("/R") copies a disk sector into a buffer 
in the C128’s memory. Once in the C128’s memory, the 
contents of the sector may be displayed in hexadecimal and 
ASCII form by using the built-in monitor’s memory dump 
command ("M"). The buffer is located at $B00 in bank 0, so 
the command to display the entire sector is "M B00 BFF" 
($B00 is the autoboot disk sector buffer. Note that this 

age of memory is also used for the cassette buffer, and so 
1S pat tts with any routines which might want to reside 
there). The memory display may be edited in the normal 
manner. Alterations made in this way affect only the copy 
of the sector in the C128’s memory however, and no changes 
are made to any actual disk sector until the contents of the 
disk sector buffer are deliberately copied back to disk 
using the write command ("/W"). 


Both the read and write commands may optionally be followed 
by disk track and sector numbers. If a track and sector are 
specified they are checked only to see if they are each in 
the range 0-99, which allows the program to create a 
syntactically legal direct access command. It is left up to 
a drives’ DOS to complain if the command cannot be complied 
with (usually because the DOS does not recognize the 

“stence of the requested track and sector). This approach 
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is designed to avoid having to hard code into the program 
the internal arrangement of any past, present or future disk 
format by taking advantage of the user’s knowledge and the 
DOS’ intelligence. 


If a track and sector are not specified, both the read and 
write commands use default track and sector values. In the 
case of the read command the contents of the first two bytes 
of the disk sector buffer are used as the track and sector 

to read. This is based on the assumptions that the contents 
of the buffer represent one sector ina series of sectors 
logically linked together in a single file, and that the 

first two bytes in the buffer represent the link to the 

track and sector of the next sector of the file. These 
assumptions are often true, making it possible to easily 
trace forward through the system of links tying files _ 
together under Commodore DOS. Particular conditions under 
which the assumptions are untrue include reaching the last 
sector of a file and before the program has read its first 
sector. 


The write command defaults to using the values found in the 
current track and current sector variables maintained by the 
program. Since these variables will usually have last been 
set by the most recent read command, the default action 
normally amounts to puline the Coeeius modified) sector 
currently in the disk sector buffer back where it came from. 


The "/#" command is used to set the device and drive to 
which the program will read and write. The program defaults 
to device 8, drive 0. The "/Q" command resets the built-in 
monitor’s command indirect vector to the value it had when 
the disk monitor was first installed, which effectively 

disables the disk monitor. 


ABOUT THE PROGRAM: _ a 

The main command loop of the built-in monitor is designed to 
accept a line of input, find the first non-space character 

on the line, and then jump through an indirect vector. 
Normally this vector points to a routine which tries to 

match that first character to the commands the monitor 
knows. DISKMON128 re-points the indirect vector to its own 
match routine, which checks if the character found is the 

disk monitor wedge character ("/"). If not, control passes 

to the original command match routine. If so, the program 
aem pes to match the second non-space character of the 
input line to a known disk monitor command, and reports an 
error if it cannot do so (two-character rather than 
one-character commands are required mainly because the 
letter "R" is already employed by the built-in monitor for 

its "R"egister command and no alternative one-character 
command seemed to make as much intuitive sense as "/R"ead). 


DISKMON128 opens and closes a direct access channel to a 
drive for every read or write attempt rather than opening 

and closing once for each session with a disk. The time 

cost of doing this is virtually unnoticeable, and it 

actually saves code space since session management commands 
(eg., changing disks) are not needed. 


High-level Kernel file routines are used exclusively rather 

than going to the low-level Kernel serial bus routines. 

There are a number of mass-storage devices which ao 
themselves into the indirect vectors of the high-leve 
routines, and the program should work with any of them which 
recognize the normal Commodore DOS direct access commands 
(cB. an SFD-1001 drive with a parallel cable should, but an 

U with a Commodore DOS program won't). 


It is unfortunate that after having provided a documented | 
method of intercepting the built-in monitor, Commodore did 
not provide a documented method of returning to it. The 
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* (128 Simple Disk Monitor 


* last revision: 


12/08/88 


* written by Anton Treuenfels 


* 5248 Horizon Drive 


* Fridley, Minnesota USA 55421 


* 612/572-8229 
* assembly flags 


LST OFF 
REL 


* program constants 


CR = $00 
CSR = $10 
SPC = $20 
QUE = $3F 
DACLF = 13 

CMDLF = 15 

RLOINT = $40 
RLOIGD = $04 
RLOIEX = $02 
RLODWN = $01 


* program memory use 


ADDR = $60 
REAWRI = $A98 
OLDMON = SABA 
CRRDVC = $ABC 
CRRDRV = $ABD 
CRRTRK = $ABE 
CRRSCT = S$ABF 
DSKBUF = $800 
FREEND = $1C00 
RLOFRE = $1C03 


* monitor memory use 


STKPTR = $09 
Acci = $60 
MONPTR = $7A 
BUF = $200 
IMON = $32E 
MSGBUF = $A80 


* monitor ROM 


MNLOOP = $B088 
NUMPRA = $B7CE 
* Kernel vectors 
CLSALL = $FF4A 
SETBNK = $FF68 
PRIMM = $SFF7D 
SETLFS = $FFBA 
SETNAM = $FFBD 


;monitor Listing 
zlink file 


;direct access 
;channel file# 
7;command channel 
;tile# 


jpcall init 
7 ind guard 
7ind execute 
pend address 


;pointer 
;tead/write flag 


j;old command vector 
,current device 
j;current drive 
,current track 
;current sector 


7;disk buffer (boot 
j;block buffer) 


; free RAM block end 


7; free RAM 
; ‘arbitrator’ 


;stack pointer save 
;numeric accumulator 
; input buffer 
;pointer 


7 input buffer 


;command execute 
j;vector 


;disk command buffer 


;monitor main loop 
;get numeric 
; parameter 


;close all files on 
;device 

7set i/o bank 
sprint immediate 


set file#, device, 
7 command 
7set filename 


OPEN 
CHKIN 
CHKOUT 
CLRCHN 


CHROUT 
GETIN 


pe a =_ 


$FFCO open file 

SFFC6 ;set input file 

SFFC9 ;set output file 

SFFCC j;set default i/o 
ifiles 

$FFD2 poutput byte 

SFFE4 7 input byte 


kkkkkkkkkkkKKKRKKKe RK KR RK 


DSK "DSKMON128.RLO" 
* RLO header 
RLOHDR TXT 'rlo' 
DA FREEND jstay in free RAM 
DA RLOFRE ;RLO arbitrates 
DFB O jbank O 
DFB RLOINT.RLOIEX 
DFB CR 
TXT 'diskmoni28 v120888' 
DFB CR 
TXT ‘by anton treuenfels' 
DFB CR,00 
* install 
INSTAL LDX #3-1 
LDA #$00 
JBB1 STA CRRDRV,X j;current drive, 
j;track, sector 
STA DSKBUF,X ;for /r or /w 
;without params 
DEX 
BPL JB81 
LDA #8 ,default device 
STA CRRDVC 
CLC 
JSR SETVCT ;set wedge vector 
RTS 
* look for disk monitor command 
DSKMON CMP #'/' j;wedge token? 
BEQ MONTOK jb:yes 
JMP (OLDMON) ;to normal handler 
MONTOK JSR GETSPC j; look for monitor 
7 command 
BEQ RETERR 
LOX AMONADR-MONCMD-1 
JBB1 CMP MONCMD,X 
BEQ HAVCMD 3b: found command 
DEX 
BPL J8B1 
RETERR LOX STKPTR j;restore stack 
TXS 
JSR PRIMM ;report problem 
DFB CSR,QUE,$00 
RETMON JMP MNLOOP ;back to main loop 


* found command 


HAVCMD TXA 
ASL 
TAX 
LDA 
PHA 
LDA 
PHA 
RTS 


MONADR+1,X 


MONADR, X 


* monitor commands 


MONCMD TXT 


MONADR DA 
DA 
DA 
DA 


‘arw#' 


EXQUIT-1 
EXREAD-1 
EXWRIT-1 
EXDEVC~-1 


* execute quit 


EXQUIT SEC 
JSR SETVCT 
JMP RETMON 











* set indirect vector(s) 


SETVCT LDX #2-1 
JBB1 LDA OLDMON,X 
BCS :1 


LDA 
STA 
LDA 
71 STA 
DEX 
BPL 
RTS 


IMON, X 
OLDMON, X 
RPLVCT,X 
IMON ,X 


1881 


RPLVCT DA DSKMON 
* execute read/write 


EXREAD LDA #'1' 
DFB $2C 
LDA #'2' 
STA REAWRI 
JSR TRKSCT 
JSR MAKDAC 
JSR CLSFIL 


EXWRIT 


JSR OPNDIR 


BCS :1 

JSR RWSECT 
JSR CLSFIL 

71 JMP RETMON 


;b:replace old 
;vector 
jsave old vector 


sset new vector 


jiut' 


z'ue! 

j;read/write flag 
;get track/sector 
;make command : 
;close files on 
jdevice 

jopen direct access 
jfile 

7b: can't open 
j;read/write sector 


* open direct access disk file 


LDA #$00 

JSR SETNAM 
LDA #CMDLF 
JSR OPNFIL 
BCS :1 

LOX #<DACNAM 
LOY #>DACNAM 
LDA #1 

JSR SETNAM 
LDA #DACLF 
JSR OPNFIL 
4 RTS 


OPNDIR 


DACNAM TXT ‘#' 


* open disk file 
OPNFIL TAY 
LDX CRRDVC 
JSR SETLFS 
LDA #$00 
TAX 
JSR SETBNK 
JSR OPEN 
BCS :1 
JSR DISKST 


BCC :1 
JSR CLSFIL 
SEC 

=I RTS 

* close disk files 


CLSFIL LDA CRRDVC 
JSR CLSALL 


RTS 


j;command file 


;b:error 


jdirect access file 


;secondary address 


;check status 
;message 
jb:ok 

j;close files 


j;close everything 
zon device 
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As it is, DISKMON128 is vulnerable to a ROM revision (in for 
a penny, in for a pound - the decision to use a ROM routine 

to collect numeric parameters must be blamed solely on a 
desire to save about 80 bytes of code. It 1s just as 
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the built-in mnaior thit routine is at the same level as 

the main loop, so calls from and returns to the main loop 

are handled as direct jumps foe — to BASIC 7.0’s 
Ww 


command dispatch routine, is a subroutine of the main 


loop. After being intercepted, command can be returned to vulnerable to ROM revisions, and there is really no excuse 
the main oe ae by executing an "RTS" instruction). for it. I simply yielded to temptation on this one “as lo 
This is a workable, if not exactly academically sanctioned, as I have to use an undocumented return call anyway...”). 
method of doing . However it would be handier if in 

the jump table at the start of the built-in monitor’s ROM ABOUT THE SOURCE: 


Commodore had provided another entry, one which pointed t 
the start of the mais command loop. This would make oe 


DISKMON128 was written a the Merlin 128 assembler. The 
: : : S 
returning after interception less of a chancy business. 


most notable idiosyncratic pseudo-ops employed in the source 
are REL and DSK. REL instructs Merlin to create a linkable 
file instead of a normal object file. Merlin requires that 
linkable files be assembled directly to disk, which is 
accomplished with the DSK directive. 





SSS lS SSSsSS ST SST SSS SS Qusssestessesssszesss= ———<—<—<—<——_——— oa Sess SSS STS SSS OSS SS SSS SSS SSS SSS SSS = Q=as=s= ssSSS=S=S— 
JSR DISKST BCS TKS1 j;b:not found 
* read/write sector 21 RTS STA CRRTRK 
JSR GETBYT ;get sector# 
RWSECT LDA REAWRI * send disk command BCC TKS2 7b: found 
CMP #'2' ;write? NUMERR JMP RETERR 
BEQ :2 ;b:yes DSKCMD STX ADDR 
JSR SNDBUF ;command read STY ADDR+1 TKS1 LDA REAWRI 
BCS :1 ;b: error LDX #CMDLF CMP #'2' pwrite? 
JSR RDDBUF ;read buffer JSR CHKOUT ;'Listen' BEQ TKS3 ;b:yes - use 
21 RTS BCS :1 ;b:error ;current values 
LDY #0 LDA DSKBUF ; follow Link to 
:2 JSR WRDBUF ;write buffer LDA (ADDR),Y ;first char shext sector 
BCS :3 JBB1 JSR CHROUT STA CRRTRK 
JSR SNDBUF ; command write INY LDA DSKBUF+1 
73 RTS LDA (ADDR),Y TKS2 STA CRRSCT 
BNE JBB1 TKSS RTS 
* copy disk buffer to computer JSR CLRCHN ;‘unlisten' 
cLC * get byte value 
RDDBUF LDX #DACLF 21 RTS 
JSR CHKIN 7 talk’ GETBYT JSR GETNUM 7;get number 
BCS :1 * disk command messages BCS :1 ;b:no number 
LbY #0 LDA ACCi+2 
JBB1 JSR GETIN ; input byte DCREAD TXT 'u1:13,0,01,00',00 BNE NUMERR jb: too big 
STA DSKBUF ,Y DCPTRO TXT 'b-p:13,0',00 LDA ACCI+1 
INY BNE NUMERR 
BNE JB81 * check disk status LDA ACC1 
JSR CLRCHN ;‘untalk' 21 RTS 
CLC DISKST LOX #CMDLF 
21 RTS JSR CHKIN 3'talk' * get numeric value 
BCS :2 jb:error 
* copy computer to disk buffer JSR GETIN ;first byte of GETNUM JSR NUMPRM get numeric 
jstatus message ;parameter 
WRDOBUF LDX #<DCPTRO CMP #'2' ;is this an error BCS NUMERR jb:too big 
LDY #>DCPTRO ;message? BNE :1 7b: found number 
JSR DSKCMD jbuffer pointer to Bcc :1 zb:no SEC ;flag not found 
7start JSR PRIMM 31 PHP jsave flag 
BCS :1 DFB CR,$00 JSR GOTDLM ;check last char 
LDX #DACLF JBB1 JSR CHROUT ;display error BNE NUMERR zb:not legal 
JSR CHKOUT ;' listen’ ;message ;terminator 
LDY #0 JSR GETIN PLP 
, JBB1 LDA DSKBUF,Y CMP #CR RTS 
JSR CHROUT ;output byte BNE JB81 jsets carry when 
INY ;true * character fetches 
BNE J681 21 PHP 
JSR CLRCHN ;'unlisten' JSR CLRCHN ;'untalk' GOTDLM DEC MONPTR 
CLC PLP GETDLM JSR GETCHR 
21 RTS :2 RTS BEQ :1 sb:end of input 


